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Change 4 to LTSS-9, CDC 6600 System Calls and I/O Requests, 


Edition 3, May 27, 1969. 


A new FROST system 576 was put on the G machine January 29, 1974. 
This system has the following new features and changes. Where the changes 
aliect I. TS5-¢,. the page number 1s snown-and the Change page is attached, 


1) 


system 576 implements an execute-only file. An execute-only file 
can be executed but not accessed. 


Create call, p. 6 
e Opencall, p. 9 
@ Close call, p. 26 


New options have been added to the Create call that allow single or 
multiple access to a pack. These are restricted options. (See 


p. 6.) 


Divisional file packs can be taken in and out of the system. (Opera- 
tions change; no pages affected.) 


System 576 fixes a system bug. An error return (SS=10) will be 
returned if a user tries to create a file at a level greater than K (7), 
or if the level is not a legal level for the operating machine. Prior 
systems set $5=10, but gave a good return. (Operations change; 

no pages affected.) 


e Legal G machine unclassified levels: U (1), A (8), K (7). 
@ Legal G machine classified levels: U (1), P (2), A (8), K (7). 
@ Legal L machine levels: U (1), P (2), A (3), S (5), K (7). 


Please insert the change pages indicated below into your copy of LTSS-9. 
Discard the replaced pages, and insert this transmittal letter before the title 
page of the chapter. Changes to a page are indicated by the black change bars 
lIn-ine mar ein; 


RAC/Ih 


Cover 6a 
Title 9 

la LS 
jue: 24 
4a 26 
4b 54 
6 ODD, 
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Worker Systems Group 
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December 14, 1973 


To: All Holders of LTSS-9 
pubject: ‘Chatige 3.16 LT55+9) CDC G000 System Calls and l,O Requests, 
Edition 3: May 27, 1969, Change 2: September 15, 1972. 


From: Harriet Coverston 


Attached are replacement pages for LTSS-9, Edition 3. Changes or 
corrections are indicated by black bars in the margin, 

Public files are distinguished by user number = 09900900. All users can 
access these files, but only user 999998 can change the status of a Public 
file. 

Divisional files are also distinguished by user number = 9090090. However, 
each divisional file has an owner division associated with it. There are two 


types of divisional files: 


1. Global Access — all users may access this divisional file, but only 
the users belonging to the owner division may change the status of 
this file. 

2. Restricted Access — only the users belonging to the owner division 
may access this divisional file. Also only the users belonging to 
the owner division may change the status of the file. Both types 
of divisional files may have a protection level specified. This 
effectively limits access to those users (Global or Restricted) 


logged in at the file level or higher than the file level. 


Harriet Coverston, Ext. 3098 
Worker Systems Group 
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Ext: 7679 
October 20, 1972 
To: All holders of LTSS-9 (Ed. 3, Change 2), CDC-6600 
System Calls and I/O Requests 
Prom: Keith A. Dawson 
mubject: Errata 1 


Replacement Notice: This document supersedes Octopus Communique No. 
311, Sept. 30, 1970. 


Please make the following corrections to your copy of LTSS-9. 


Page lb 
Add OC-311 (Sept. 30, 1970) to the list of superseded communiques. 


Before page 4 
Attach the enclosed page 3b (this page was inadvertantly left out at 


the last revision). 


Page 6 
Add at bottom of page: 'SS=10 LL was too large (>7)." 


Page 24 
Replace text lines 5 and 6 with: 
"7's or 2's stored in BETA (7's if the PP is running because of an 
interrupt from Teletype, and 2's if the PP is running becauSe its 


contrcllee suspended waiting for a message from controller). "' 
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LY NECESSARY TO SET RURDS AND PHRASES OFF FROM THE s30Y OF THE 
» SINCE THE ENTIRE TEXT GS RRITTEN IN CAPITAL CETTERS, HE ARE 
E AS aA DISTINGUISHING CHARACTERISTIC. THEREFORE, YARILOUS 
E 


NOTATION: IT 1S FREQUEN 
TEXT. UNFORTUNATE 
UNABL io, (USe: —« 
PUNCTUATION MARKS & 


| 

boas 
r 
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Bs LANGUAGE STATEMENTS AND MESSAGE STRINGS ARE SEPARATED FROM TEXT BY QUETATIOEN 
MaRKS. FOR EXAMPLE: THE SYSTEM SENDS A MESSAGE ‘PROBLEM ERROR O200° TO THE 
TELETYPE | 

8 TO DEFINE A KORD OR PHRASE, THE TERM IS INCLUDED BETRKEEN BRACKETS ne 
FOR EXAMPLE: A <TELETYPE> {$9 A MACHINE ... 


As VARIOUS LEVELS OF NAMES ARE INCLUDED IN THE FOLLURKING TABLE: 


LEVEL PUNCTUATION EXAMPLES 
SYSTEM NAME NONE TREO PROG. SISTER. 4 
FILE NAME we ee PUCCIO AEILE /CRELIGY TS... 
PROGRAM NAME “tures SUBROUTINE -ALTER> WILL... 
VARJABLE NAME =’... Set "ABC’ EQUAL TO 


D. IT TS ALSO FREQUENTLY NECESSARY TO INDICATE CONTENTS AND LOCATIONS. THIS {[$ 
DONE BY THE FOLLORING: 
PUNCTUATION EXAMPLES 


CONTENTS CF Ceres CABC] «@ 4, 
LOCATION OF ree) (ABC) = [0472 


(LRLLTIB)« DISC ADORESSES {o7-Li2si 


TRIS NOTATION ALLORS US TO DISTINGUISH BETREEN DIFFERENT ENTITIES THAT HAVE THE SAME 
NAMES, FOR EXAMPLE, "PUBLIC FILE /OUT/ CONTAINS PROGRAM -OUT-'. PUNCTUATION 
1S OFTEN OMITTED IF THE TERM 1S ON A LINE OF [TS OWN, JS IN A TABLE, OR IS IN A LIST. 


CROSS REFERENCES: 


Lis CROSS REFERENCES HiTHIN CHAPTER 9 ARE INDICATED BY CHAPTER. SECTION, SUBSECTION 
| AND PAGE NUMBER: (SEE 9.7.1, PAGE 20). 


£. CRESS REFERENCES TO OTHER CHAPTERS ARE INDICATED IN THE SAME WAY, BUT RITHOUT 
PAGE NUMBERS: (SEE 4.7.35 AND 5.8). 


CO € 
NO 


9.3, 


9.4, 
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Contents 


Formats for System Calls 

Calls to FROST 

9.2.1. Create 

Destroy 

Open ; 

This Problem Program is Finished 
Give Files to Other Users 

Send a Message to the Operator 

Get File Index or Active Users List 
Give Tapes to Controllee : ; 
File Name, Program Name, Account Number, -and- 
Donate Time 

10. Give up File Space 

.l1. Adjust Core Space : 

12, Send a Message to the Cont elice 
13. Send a Message to the Controllee 
14. Get a Message from the Controller 
.15. Get a Message from the Controllee 
16. Get Symbols from the Controller 
17. Get Symbols from the Controllee 

. Initialize or Disconnect a Controllee 
sto. Close 


DO DO HD PD DD WD DW LO 
OoOonND uF Ww dO 
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21, Automatic Suspend and Restart 
22, Message Bypass Control 

.23, send a Message to Device 

.24. Get a Message from Device 


Is to CMPPU 


= NNNNNNNNNNNNNNDND 
— 
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3.1. Request Time Clock ; 
3.2. Give Up CPU — Next Turn 
3.3. Give up CPU —I/O 
3.4. Return from an Interrupt Routine 
3.9. set or Clear SCOPE Flag 
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59.10. Read Tape Unit Status” 
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9.1, FORMATS FOR SYSTEM CALLS 


FROST WILL EXAMINE AAAAAA, BBBBBB, RETURNe!, AND ANY OTHER ADDRESSES INVOLVED FOR 


OUT*OF-BOUNDS MEMORY REFERENCES, 


HARDWARE INTERRUPT. 


IF ANY ONE OF THEM I$ OUT-GF-BOUNDS, IT JS TREATED AS A 


THE FOLLOWING IS A LIST OF THE AVAILABLE CALLS TO FROST, WITH REFERENCES TO THE PAGES ON 
WHICH MORE DETAILED INFORMATION MAY BE FOUND. 


26 
31 
32 


PAGE 


29 
30 
30a 
30d 


NAME OF CALL 
CREATE. 
DESTROY, 
OPEN, 
THIS PROBLEM PROGRAM 1S FINISHED, 
GIVE FILES TS OTHER USERS. 
SEND A MESSAGE TO THE OPERATOR, 
GET FILE INDEX LIST 6R GET ACTIVE USERS LIST. 
GIVE TAPES TO CONTROLLEE. 
CHANGE FILE NAME -OR+ DONATE TIME -O@R= CHANGE ACCOUNT NUMBER 
CHANGE PROBLEM PROGRAM NAME, | 
GIVE UP FILE SPACE, 
ADJUST CORE SPACE -6R- LOAD AT LOW ADDRESS. 
SEND A MESSAGE TS THE CONTROLLER, 
SEND A MESSAGE TO THE CONTROLLEE. 
GET A MESSAGE FROM THE CONTROLLER. 
GET & MESSAGE FROM THE CONTROLLEE. 
GET SYMBOLS FROM THE CONTROLLER, 
GEY SYMBOLS FROM THE CONTROLLEE, 
INITIALIZE OR DISCONNECT A CONTROLLEE. 
CLOSE, 


“(Re 


MOOSFY TIME LIMIT OR PRIORITY -OR- GET USER NUMBER AND BANK 
ACCOUNT -OR- GET TIME LIMIT AND PRIORITY -GR- GET PERCENTAGE TIME 


CHARGED -OR- GET PROBLEM PROGRAM NAME AND FIELD LENGTH -GR- 


DESCRIPTOR BLOCK AND USER BLOCK TABLES. 
AUTOMATIC SUSPEND AND RESTART, 
INPUT/GUTPUT BYPASS CONTROL. 

yend a message to device. 

Get a message from device. 


GET 


THE FOLLOWING 1S A LIST OF THE AVAILABLE CALLS TS CMPPU, WITH REFERENCES TO THE PAGES ON 
WHICH MORE DETAILED INFORMATION MAY BE FOUND, 


TITT 
VU0t 
0002 
CC10 
0020 


PAGE 
31 
32 
32 
34 


NAME OF CALL 
REQUEST TIME CLOCK. 
GIVE UP CPU == NEXT TURN, 
GIVE UP CPU ->° INPUT/OUTPUY, 
RETURN FROM AN INTERRUPT ROUTINE. 


LTSS-9 
Erratum: Oct. 20, 1972 


9.1. FORMATS FOR SYSTEM CALLS 
Page 3b 


A system call is a request by a problem program for certain functions to be per- 
formed. With the exception of the ''THIS PP IS FINISHED" call, there are no restrictions 
on the frequency or volume of system calls. 

The method of issuing a system call is as follows: 

1. A halt instruction (00) is placed in the first thirty bits of a word (relative 
word zero). 

2. Information about the nature of the request is stored in the last thirty bits 
of relative word zero, 
The problem program executes a transfer to location zero. 
IMPPU will frequently read the CPU program counter. When the program 
counter is a zero, IMPPU will read relative word zero and take appropriate 
action, 

All registers are preserved for any system call. This statement remains true 
regardless of the number of calls in queue for a given problem program, 


In all cases, the last thirty bits of relative word zero have the (octal) format 
TTTTA AAAAA 


where 
ge Ha indicates the type of call. If TTTT = 1004, the call is processed by 
FROST. Otherwise, the call is processed by CMPPU. 
AAAAAA is usually the address of another word, ALPHA, which further 
defines the specific system service desired. 
In case of a call to FROST (TTTT = 1004), word ALPHA has the (octal) format: 


CCNNR ETURN XXXXB BBBBB 


where: 

CC is the code number that determines the type of call. 

NN is certain information required for the call. 

RETURN is an address. If this system call has not successfully completed, 
control will be sent to RETURN. If the call is successfully 
completed, control will be sent to RETURNG+1. 

XXXX is certain information required for the call. 

BBBBBB is usually the address of a second word, BETA, that contains 
additional information required for the call. The format of the beta 
word(s) is discussed with each individual call. 

In case of a call to CMPPU (TTTT is not 1004), the meaning of AAAAAA is 
discussed with each individual call. 

In addition to the (priority weighted) charge for CPU time used, each problem pro- 
gram is charged for system calls as follows: 

1, No charge for calls beneficial to the system (this includes all calls to CMPPU). 

2. Two milliseconds for any call not beneficial to the system. 

3. 64 milliseconds +(4 microseconds X problem program field length) for each 

load and dump of problem program, provided these loads and dumps were not 


system initiated due to priority dumps, 


LTSS-9 
Change 4: Jan. 29, 1974 


9.1. FORMATS FOR SYSTEM CALLS 
Page 4a 


A system call is a request by a problem program for certain functions to be per- 
formed, With the exception of the ''THIS PP IS FINISHED" call, there are no restrictions 
on the frequency or volume of system calls. 

The method of issuing a system call is as follows: 

1. A halt instruction (00) is placed in the first thirty bits of a word (relative 
word zero), 

2. Information about the nature of the request is stored in the last thirty bits 
of relative word zero. 
The problem program executes a transfer to location zero, 

4, IMPPU will frequently read the CPU program counter. When the program 

~ counter is a zero, IMPPU will read relative word zero and take appropriate 

action, | 

All registers are preserved for any system call. This statement remains true 
regardless of the number of calls in queue for a given problem program. 


In all cases, the last thirty bits of relative word zero have the (octal) format 
TTTTA AAAAA 


where 
Bas ad a indicates the type of call. If TTTT = 1004, the call is processed by 
FROST. Otherwise, the call is processed by CMPPU, 
AAAAAA is usually the address of another word, ALPHA, which further 
defines the specific system Service desired. 
In case of a call to FROST (TTTT = 1004), word ALPHA has the (octal) format: 


CCNNR ETURN XXXXB BBBBB 


where: 

CC is the code number that determines the type of call. 

NN is certain information required for the call. 

RETURN is an address. If this system call has not successfully completed, 
control will be sent to RETURN. If the call is successfully 
completed, control will be sent to RETURN+1. 

XXX X is certain information required for the call. 

BBBBBB is usually the address of a Second word, BETA, that contains 
additional information required for the call. The format of the beta 
word(s) is discussed with each individual call. 

In case of a call to CMPPU (TTTT is not 1004), the meaning of AAAAAA is 
discussed with each individual call. 

In addition to the (priority weighted) charge for CPU time used, each problem pro- 
gram is charged for system calls as follows: 

1. No charge for calls beneficial to the system (this includes all calls to CMPPU). 

2. Two milliseconds for any call not beneficial to the system. 

3, 64 milliseconds +(4 microseconds X problem program field length) for each 

load and dump of problem program, provided these loads and dumps were not 


system initiated due to priority dumps. 
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9,{. FORMATS FOR SYSTEM CALLS 
FROST WILL EXAMINE AAAAAA, BBBBBB, RETURN+!, AND ANY OTHER ADDRESSES INVOLYED FOR 
GUT-GF-BOUNDS MEMORY REFERENCES. JF ANY ONE OF THEM 1S OUT-GF-BOUNDS, IT 3S TREATED aS A 
WARDKARE INTERRUPT. , 


THE FOLLOWING IS A LIST OF THE AVAILABLE CALLS TO FROST, RKITH REFERENCES TO THE PAGES ON 
WHICH MORE DETAILED INFORMATION MAY BE FOUND. 


Ce PAGE NAME OF CALL 

01 6 CREATE, 

02 7 DESTROY. 

03 9 OPEN, 

04 10 THIS PROBLEM PROGRAM 1S FINISHED. 

05 tI GIVE FILES TS QTHER USERS. 

06 12 SEND A MESSAGE TO THE OPERATOR, 

07 13 GET FILE INDEX LIST 8R GET ACTIVE USERS LIST. 

10 14 GIVE TAPES TO CONTRILLEE. 

tt 15 CHANGE FILE NAME -OR- DONATE TIME -OR> CHANGE ACCOUNT NUMBER -OR- 
CHANGE PROBLEM PROGRAM NAME, 

{2 16 GIVE UP FILE SPACE. 

13 ; ADJUST CORE SPACE -OR- LOAD AT Lon ADDRESS. 

\4 18 SEND A MESSAGE TS THE CONTROLLER, 

15 19 SEND A MESSAGE TS THE CONTRELLEE. 

(6 GET A MESSAGE FROM THE CONTROLLER, 

17 22 GET A MESSAGE FROM THE CONTROLLEE, 

20 22 GET SYMBOLS FROM THE CONTROLLER, 

2! 24 GET SYMBOLS FROM THE CONTROLLEE, 

22 2! INITIALIZE OR DISCONNECT A CONTROLLEE. 

23 26 CLOSE, | 

24 27 MODIFY TIME LIN{T OR PRIORITY -8R- GET USER NUMBER AND. BANK 


ACCOUNT -OR- GET TIME LIMIT AND PRIORITY -OR- GET PERCENTAGE TIME 
CHARGED -dOR- GET PROBLEM PROGRAM NAME AND FIELD LENGTH -GR- GET 
DESCRIPTOR BLOCK a) USER BLOCK TABLES. 


25 29° AUTOMATIC SUSPEND AND RESTART, 

26 | 30 INPUT/GUTPUT SYPASS CONTROL. 

31 30a Send a message to device. 
32 30d Get a message from device. 


THE FOLLOWING IS A LIST OF THE AVAILABLE CALLS TO CMPPU, WITH REFERENCES TO THE PAGES ON 
WHICH MORE DETAILED INFORMATION MAY BE FOUND. 


TITT PAGE NAME OF CALL 

VUOt gene 2S REQUEST TINE CLOCK, 

0002 | 32 GIVE UP CPU -* NEXT TURN, 
CC10 a6 GIVE UP CPU s+ INPUT/OUTPUT, 


0020 34 RETURN FROM AN INTERRUPT ROUTINE. 


0021 
0022 


34 


Change 2: Sept. 15, 1972 


Page 5 


Allow interception of SCOPE (a CDC operating 
system) system calls for modification to FROST 
system calls. 

21 = clear SCOPE flag. 

22 = set SCOPE flag. 


Change 4: Jan, 29, 1974 


Page 6 
9.2. CALLS TO FROST 


9.2.1. Create 


This call reserves Space on disc for a hitherto nonexistent file or set of 
files, and/or reserves an input/output unit or group of units (not disc) for 
use by this problem program in addition to reserving the requested items, 


this call makes it possible for the requesting problem program to communi- | 
cate with them. 


Format: 
Word O: 00000 00000 1004A AAAA 
where: 
AAAAAA is the address of word ALPHA 


Word ALPHA: 01NNR ETURN O0ODDB BBBBB 


where: 

OF is the code for 'create!. 

NN is the number of files and/or devices, 

RETURN is an address, If this system call was not successfully | 
completed, control will be sent to'return'. If the call 
is successfully completed, control will be sent to 
'returnt+l!'., 

DD indicates which option is desired. 

DD=00 for a normal create. 


DD=01 for the drop-file request (destroy duplicate 
file option). 
DD=02 for the drop-file request (do not destroy 
duplicate file option). 
BBBBBB is the address of the first word, BETA, of the NN (less 
than Seventeen) requests. | 


Word BETA: Name of disc file, or tape vault number (ASCII, right 
(DD=00) justified), For disc files, the name may be up to ten 
characters long; for tape vault numbers, up to six 
characters; for G machine online scopes, one ASCII 
character = J, K, L, or M. 


Word BETA: The name of the drop file. If there is already a file by this 
(DD=01,02) name, FROST will destroy it (if DD=01) or transfer control 
to the error return (if DD=02). If BETA=00, FROST will 
generate a recognizable and unique ASCII name. 


RB Word BETA+1: MMSST TUUXX LLWWW WWWWW 


(DD=00) 
where: | 
MM is the minus word designation for this file. 
SS is filled in (by FROST) on completion of the system call, 


as follows: 

SS=00 normal completion. 

~SS=01 name duplication or name not in file index, For 
TT = 05 or 45g, pack is not there. 

SS=02 not enough space, 

SS=03 access denied (SCOPE not available if TT=03). 
For TT = 459, pack is locked out, | 

SS=04 format or parameter error, 


Change 4: Jan. 29, 1974 


Page 6a 


SS=05 operator initiated tape error (tape not in vault), 

S5S=07 file index or disc trouble, 

55=10 LL was greater than 7 or LL was not a legal a 
machine level. 

5S=12 (DD=02) file already exists. 

SS=13 (DD=01) FROST cannot destroy the existing file, 


TT is type of unit: 
TT=00 disc. 
TT=01 half-inch tape. 
‘TT=02 one-inch tape. 
TT=03 G machine devices (G machine only). 
TT=05 disk pack, multiple access (restricted use). ‘ 
TT=45 dise pack, single access (restricted access). 
TT=11 dd80 (L-machine only). 

UU If TT=00, then UU is disc Specification, if desired (01, 02, 
or 03), on which this file is to be created. FROST will fill 
in, upon completion and only if it was originally non-zero, 
the disc (1 through 3) on which it was actually created. If 
it was zero when the call was made, the file will be 
created on a round robin basis on the next Disc where 
Space is available, and FROST will leave UU=0. If the file 
cannot be created on the disc requested due to lack of space 
or due to the disc being "locked out", the file will be 
created on the next available disc. 


If TT=01, then UU is the tape unit number assigned by the 
machine operator. 

LE is the access level (a number 0-7). If LL=0 the file will be 
created at the operating level of the creator. 

xX specifies file type. If XX=05 file is execute-only drop file J 
(DD=01, 02). 

WW... W is the word length for this file. WW...W is examined if 
and only if TT=00 (i.e., disc). For TT =05 or 45, the 
physical pack number will be returned by FROST. 

Word BETA+1: The length at which the drop file is to be created (at least 
(DD=01,02) 4019). If BETA+I1 is zero, FROST will generate a length 
sufficient to contain the calling program. 
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9.2. CALLS TO FROST 


WORD BETA+2: SAME AS BETA 
BETA+3S: SAME AS BETA 


@ ¢ 6 


BETA#30: SAME AS BETA 
BETA+3S1; SAME AS BETA#I 


FOR SS > 00, CONTROL WILL GO TO "RETURN’; MINUS HORDS MAY NOT BE SET. 
FOR SS « 00, CONTROL WILL GO TO 'RETURN+{’; MINUS HORDS HILL BE SET. 


FOR TT »© OL AND TT © O02, THE SIX*CHARACTER TAPE VAULT NUMBER HILL BE TYPED ON THE 
OPERATOR'S TELETYPE. THE OPERATOR WILL LOCATE THE REQUESTED TAPE AND MAKE IT AVAILABLE 
TO THE SYSTEM. 


CREATES ARE PROCESSED IN THE FOLLOWING ORDER, REGARDLESS OF THE ORDER IN WHICH THEY ARE 
ISSUED: 

le. TAPES. 

2. OTHER NON-DISC EQUIPMENT, 

3. BUSC. PILES. 


AN ERROR RETURN WILL BE GIVEN [F THE LENGTH OF THE FILE [S$ A NEGATIVE NUMBER, 


CHARGE: 2 MILLISECONDS. 


Pe buke DESTROY 


THIS CALL ALLOKS THE PROBLEM PROGRAM TO GIVE UP DISC FILES AND/OR RELEASE INPUT/OUTPUT 
DEVICES (OTHER THAN TELETYPE). IN THE CASE OF GIVING UP DISC SPACE, THE DISC SPACE 
PRESENTLY BEING OCCUPIED BY TRE SPECIFIED FILE OR SET OF FILES [S$ GIVEN BACK TS THE SYSTEM 
FOR REASSIGNMENT x(t)x. IN ADDITION TO RELEASING THE SPECIFIED ITEMS, THIS CALL MAKES IT 
IMPOSSIBLE FOR THE REQUESTING PROBLEM PROGRAM TO COMMUNICATE WHITH THEM, 


FORMAT: 
WORD 0: 00000 06000 {004A AAAAA 
KHERE: 
AAAAAA JS THE ADDRESS OF WORD ALPHA. 


e({)x COMPARE ‘CLOSE’, PAGE 26. 


Change 3: Dec. 14, 19738 
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ee CALLS TO FROST 


WORD ALPHA: O2ZNNR ETURN COOOB BBBBB 
HHERE: 

02 IS THE CODE FOR ‘DESTROY’. 

NN 1S THE NUMBER OF DESTROY REQUESTS. 

RETURN IS AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL KILL BE SENT TO ‘RETURN’. JF THE CALL [S SUCCESSFULLY 
COMPLETED, CONTROL. WILL -GE SENT TW. 7 RETURN EL”, 

BBBBBB IS THE ADDRESS OF THE FIRST HORD, BETA, OF THE NN (LESS THAN SEVENTEEN) 


REQUESTS. 
HORD BETA: NAME GF DISC FILE, OR TAPE VAULT NUMBER (ASCII, RIGHT JUSTIFIED). 
HORD BETAet: MMSST TUUGO 09909000000. : 
WHERE: 
MM 1S THE MINUS HORD FOR THIS FILE. 
Ss 1S FILLED IN (BY FROST) ON COMPLETION OF THE SYSTEM CALL, AS FOLLOHS: 
$S°00 NORMAL COMPLETION, 
SSeO{ NAME NOT IN FILE INDEX, 
$Se03 DESTROY NOT ACCOMPLISHED (WRONG MINUS HORD OR NAME), 
$S<04 FORMAT OR PARAMETER ERROR, 
$Se05 ANOTHER CURRENTLY EXECUTING PROBLEM PROGRAM HAS THIS FILE OPEN. 
$Se06 TAPE DESTROY ERROR (HRONG NAME OR VOID). 
SSe07 DISC MAP TROUBLE. FILE NOT DESTROYED. 
TT IS TYPE OF FILE: 


TT«00 bist. 
TT«Ol HALFeINCH TAPE. 
TT«02 ONE°INCH TAPE, 
TTel{ ¢d80 (L°MACHINE ONLY). 
UU=1 delete file from file index (User-1 only). 
HORD BETA+2: SAME AS BETA 
BETA?3: SAME AS BETA! 


FOR SS > 00, CONTROL WILL GO TO 'RETURN’; MINUS HORDS MAY NOT BE SET. 
FOR SS « 00, CONTROL WILL GO TO "RETURN¢I’; MINUS HOROS RILL BE SET. 


FROST WILL JGNORE A DESTROY REQUEST UNLESS THE FILE BEING DESTROYED KAS CREATED OR OPENED 
BY THE PROBLEM PROGRAM DURING THE CURRENT PROBLEM PROGRAM EXECUTION TIME, OR IF THE FILE 
BE PUBLIC, IF THE DESTROY REQUEST JS CARRIED OUT MINUS WORDS HILL Be ERASED. 


CHARGE: NONE. 


Change 4: Jan. 29, 1974 
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ee CALLS TO FROST 


THIS CALL MAKES IT POSSIBLE FOR THe REQUESTING PROBLEM PROGRAM TO COMMUNICATE WITH A DISC 
FILE OR SET OF DISC FILES KHICH HAVE BEEN PREVIOUSLY CREATED BY THE USER OR ARE PUBLIC 


PILES x(2)x, 


FORMAT: 
HORD 0; 00000 00060 1004A AAAAA 


HHERE: 
AKAAAA IS THE ADDRESS OF HORD ALPHA. 


WORD ALPHA: OSNNR ETURN OO000B BsesB 
WHERE: 

03 [S- TRE CODE FOR" OPEN”, 

NN 1S THE NUMBER OF FILES REQUESTED. 

RETURN JS AN ADDRESS. IF THIS SYSTEM CALL KAS NOT SUCCESSFULLY COMPLETED, 
CONTROL HILL BE SENT TO ‘RETURN’. IF THE CALL iS SUCCESSFULLY 
COMPLETED, CONTROL WILL BE SENT TO "RETURN#I’, 

BBBBBB [IS THE ADDRESS OF THE FIRST WORD, BETA, OF THE NN (LESS THAN SEVENTEEN) 


REQUESTS, 
HORD BETA; NAME OF DISC FILE (ASCII, RIGHT JUSTIFIED). 


HoRD BETA+t: MMSSP OUURR TLZZZ ZZZZZ 


WHERE: 
MM 1S THE MINUS HURD DESIGNATION FOR THIS FILE. 
S$ TS FILLED IN (BY FROST? ON COMPLETION OF THE SYSTEM CaLL, AS FOLLORKS: 


$$=C0 NORMAL CUMPLETION. 
$S«0i NaME DUPLICATION OR NAME NOT IN FiLe INDEX. 
$$«02 READ ONLY. 
$$«03 ACCESS DENIED. 
SS=10 Tried to open an execute only file. 
p 1S THE FILE TYPE, {F THE FILE OPENED IS PUBLIC, FROST HILL FILL IN Pel, 
If the file opened is divisional, FROST will fill in P-2. 
IF iT 1S PRIVATE, NO ACTION [S TAKEN BY FROST. 
WU 1S FILLES IN (BY FROST) WHITH THE NUMBER OF THE DISC UNIT (0,1,2) ON 
WHICH THE FILE RESIDES. 


RR is the read/write status of the file. | 
RR=01 for open file and set type to read/write. 
RR=02 for open file and set type to read-only. 


T is file type, filled in by FROST. 
T=2 means the file is read-only, 7 
If the file is read/write FROST does not set T. 
L is filled in by FROST with the access (classification) 


level of the file. 
ZZ...Z will be filled in (by FROST) with the number of words 


in the opened file. 


* (2) * compare 'create', page 6. 
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Vek CALLS TO FROST 


KORO HETAe?: SAME AG WHETA 
BEYAvS: SAME AS BETA! 


FOR SS « Of AND SS « O03, CONTROL KILL GO TO 'RETURN’; MINUS HORDS MAY NOT BE SET. 
FOR SS « 00 AND SS = O02, CONTROL WILL GO TO 'RETURN+I"’; MINUS HORDS WILL BE SET. 


CHARGE: 2 MILLISECONDS. 


ee Se THIS PROBLEM PROGRAM IS FINISHED 


THIS CALL INDICATES THAT THIS PROBLEM PROGRAM HAS RUN TO [TS NORMAL TERMINATION POINT, 
THE REQUESTING PROBLEM PROGRAM HILL NOT RECEIVE ANY MORE COMPUTER TIME. AS SJUN AS ALL 
MESSAGES ORIGINATED BY JT HAVE BEEN DELIVERED TO ITS CONTROLLER, THE PROBLEM PROGRAM WILL 
BE DISCONNECTED FROM THE SYSTEM, 


FORMAT; 
WORD 0: 00000 00000 {004A AAAAA 
WHERE: 
AAAAAA JS THE ADDRESS OF KORD ALPHA, 
WORD ALPHA: O4D0R ESUME 00000 00000 
WHERE: 
04 IS THE CODE FOR ‘THIS PROBLEM PROGRAN [S FINISHED’. 
DD INDICATES HKHETHER THE PROBLEM PRUGRAM IS TO BE SAVED. 


D0«00 MEANS ERASE PROBLEM PROGRAM FROM CORE BUT PRESERVE [TS FINAL STATE 
De ETS SCP ee. 
DD«O} MEANS ERASE PROBLEM PROGRAM FROM CORE AND DISC. 
RESUME {S THE ADDRESS AT RKHICH TRE PP HILL START JF IT IS TO BE USED AGAIN 
(THIS FEATURE MAY BE USED TO AUTOMATICALLY INTIALI2E A SERVICE PROGRAM). 


THIS REQUESTING PROBLEM PROGRAM {S$ REMOVED FROM CENTRAL MEMORY AND STORED UNDER ITS 
EXECUTING NAME IN THE USER FILE INDEX. THE LAST MESSAGE PREVIOUSLY SENT BY THE PROBLEM 
PROGRAM 1S TRANSMITTED TC THE CONTROLLER (USER) WHEN THE CONTROLLER (USER) LOGS IN. WHEN 
THE MESSAGE TRANSMISSION TERMINATES, “ALL DONE’ WILL BE TRANSMITTED AND THE DONE 
SEQUENCE HILL BE INITIATED. CONTROL WILL NOT BE RETURNED TO THE PROBLEM PROGRAM, 


CHARGE: 2 MILLISECONDS. 


Change 2: Sept. 15, 1972 
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9.2, CALLS TO FROST 


Pek ao. GIVE FILES TO OTHER USERS 


THIS CALL MAKES (T POSSIBLE FOR ONE USER TO GIVE DATA OR PROGRAMS TO ANOTHER USER. 


FORMAT: 
WORD 0: 00000 00000 10044 AAAAA 
KHERE: | 
AAAAAA 1S THE ADDRESS OF HORD ALPHA, 


RORD ALPHA: OSNNR ETJRN OOOOB BBBBB 
WHERE: 

05 IS THE CODE FOR 'GIVE FILES TO OTHER USERS’. 

NN 1S THe NUMBER OF FILES GIVEN. 

RETURN JS AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL HILL BE SENT TO ‘RETURN’. JF THE CALL IS SUCCESSFULLY 
COMPLETED, CONTROL HILL BE SENT TO ’RETURN+I’. 

BBBBSB %I!S THe ADDRESS OF THE FIRST HORD, BETA, OF THE NN (LESS THAN SEVENTEEN) 


REQUESTS. 
RKORD BETA: NAME OF DISC FILE (ASCII, RIGHT JUSTIFIED). 
RKORD BETA: OOSSO OXXXX XXXXX XXXXX 
KHERE: 
Eb) IS FILLED (BY FROST) ON COMPLETION OF THE SYSTEM CALL AS FOLLOXS: 


$$*00 NORMAL. 

SSeOf A FILE BY THIS NAME iS ALREADY THERE, 

SS*02 PUBLIC FILE NAME (CANNOT GIVE A FILE WHOSE NAME IS THE SAME AS A 
PUBLIC FILE). 

S$S«03 THERE 1S NO FILE BY THIS NAME TO GIVE. 

SS*04 INCORRECT FORMAT FOR USER NUMBER XX...X. 

S$s05 ANOTHER CURRENTLY EXECUTING PROBLEM PROGRAM HAS THIS FILE OPEN. 


$5=06 file is currently being written or read by the 
file-transport system. 
$S=10 attempting illegal give of a classified file. 
XX...X IS THE (ASCII) USER NUMBER TO WHICH THE FILE IS TO BE GIVEN. 


WORD BETAt+2: SAME AS BETA 
BETA+3:; SAME AS BETA+! 


FOR SS > 00, CONTROL WILL GO TO ‘RETURN’; FOR SS «© 00, CONTROL AILL GO TO 
"RETURNS", 


FROST WILL CLEAR THE MINUS HORD ASSOCIATED WITH A DISC FILE GIVEN TO ANOTHER USER. 


Errata l 
December 3, 1969 
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9.2. CALLS TO FROST 


CHARGE: 2 MILLISECONDS. 


9.2.6, SEND A MESSAGE TO THE OPERATOR 


@®2Seeoevwoe ooeeeooosnee®eeeowe @® ® & @ 


BY MEANS OF THIS CALL, 3RIEF MESSAGES MAY BE SENT TO THE OPERATOR, GIVING DIRECTIONS, 
ADDITIONAL INFORMATION, CR OPINIONS. 


FORMAT: 


KORD 0: 00000 00000 1004A AnAAA 


RKHERE: 
AAAAAA 


1S THe ADDRESS OF KORD ALPHA, 


HIRD ALPHA; O600R ETURN OOMMB BBEBB 


WHERE: 
06 
RETURN 


MM 


BSBBBB 


RORD BETA: 
BETA+{: 


IS THe CODE FOR ‘SEND A MESSAGE TO THE OPERATOR’, | 

[S AN AQDSRESS. IF THIS SYSTEM CALL KAS NOT SUCCESSFULLY COMPLETED, 
CONTROL HILL BE SENT TO ‘RETURN’. IF THE CALL JS SUCCESSFULLY 
COMPLETED, CONTROL WILL BE SENT TO 'RETURNeI’, 

1S THE NUMBER OF MAIN FRAME HORDS CONTAINING THE MESSAGE (MM MUST BE 
LESS THAN NING). THE ERROR RETURN IS TAKEN IF MM IS LESS THAN OR EQUAL 
T6 00 OR JS GREATER THAN 08, | 

1S THe ADDRESS OF THE FIRST HORD, BETA, OF THE MM HORDS CONTAINING THE 
MESSAGE. | 


sa MESSAGE 5. 
GME SSAC css 


THE MESSAGE STRING MUST sxxNOTxx3 CONTAIN AN END-OGF*MESSAGE STRING (400204). 


CHARGE: 2 MILLISECONDS, 


Change 4: Jan, 29, 1974 
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Gabe CALLS TO FROST 


9.2.7. GET FILE INDEX OR ACTIVE USERS LIST 


THIS CALL ALLOHS A USER TO GET A COPY OF HIS PERSONAL FILE INDEX OR THE PUBLIC FILE INDEX, 
OR TO GET A LIST OF CURRENTLY ACTIVE USER NUMBERS AND THE CURRENT YALUE OF THEIR BANK 
ACCOUNTS. 


FORMAT: 
KORD 0: 00000 00000 1004A AAAAA 
WHERE: 
AKAAAA JS THE ADDRESS OF HORD ALPHA. 


HORD ALPHA: O7NNR ETURN MMMMB BBBBB 


HHERE: 
07 [S THE CDE POR GEs eee Tt LES th 
NN. [HDICATES WHETHER THE PUGLIC FILE INDEX, OR PRIVATE FILE INDEX, OR THE 
LIST OF CURRENTLY ACTIVE USER NUMBERS {S$ DESIRED. 
NN=0 means get public file index (does not include divisional files), 
. 2 words per file entry. 
NN=01 means get private file index, 2 words per file entry. 
NN=02 means get public and divisional index, 3 words per file entry. 
NN=03 means get currently active uSer numbers, 2 words per entry. 
NN=06 means get list of files in security pool. 
NN=10 list current User-1 tape numbers. 
RETURN {1S AN ADDRESS, JF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL WILL BE SENT TQ ‘RETURN’, TF THE CALL iS SUCCESSFULLY 
COMPLETED, CONTROL WILL BE SENT TO ’RETURN+I’. 
MMMM 1S THE MAXIMUM NUMBER OF FILES OR USER NUMBERS. BUFFER LENGTH MUST BE 
AT LEAST 2*NMMM, 
BBBSBB IS THE ADDRESS OF THE FIRST HORD, BETA, OF TRE BUFFER, 
Word BETA: N =0Oor1or2: Name of disc file (will be 
ASCII, right justified). 
Nos 3; USER NUMBER (HILL BE ASCII, RIGHT JUSTIFIED). 
Word BETA+]  N=0Oorlor2: LLXCD DDDDD DDZ2Z ZZZZZ (supplied by 


the system) 


Where: 
LL specifies the protection status 
of the file. | 
LL=01 means the file is read/write. 
LL=41 means the file is read only. 


LL=21 means file is being destroyed. 
X is access information level (0-7). 


C is channel. If on disk, C=0,1, or 2. 
If on pack, C=4, 


0D...0 %IS THE TIME LAST REFERENCED (MICROSECOND CLOCK 


SHIFTED RIGHT 24 BITS). 
dlosud -1S THE NUMBER GE WORDS IN THE FILE. 
Ne 3: USER BANK ACCOUNT (INTEGER MICROSECONDS). 


Change 38: Dec. 14, 1973 
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Word BETA+2 N=2 only: DDAU® O9O00 DOOOO 09000 
where: 
DD is the division number if divisional file. 
DD=@@ if public file. 
A is file access. | 
A=9 Global access. 
A=1 Restricted divisional access. 
U If channel (C) equals 4, U is the logical pack 


Word BETA N=10 


Word BETA+1 N=10 
F 


G 


Word BETA+2 N=10 
| H 


unit (9-7) on which the file resides. 


DDDDD DDDDD EEEEE EEEEE 


FR8O tape identification number is returned 
by FROST, 
FRAD tape identification number is returned 
by FROST. 


FRFRPEP FPRRFPE GGGGG GGGGG 


CRT tape identification number is returned 
by FROST. 

HSP tape identification number is returned 
by FROST. | 


60000 09900 HHHHH HHHHH 


DD8€ tape identification number is returned 
by FROST. 


Change 8: Dec. 14, 1978 
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6.2, CALLE 10 FROST 


For N=0.. by Or 3: 
Word BETA+2: Same as BETA 
BETA+3: Same as BETA+1 


For N=2: 
Word BETA+t3 same as BETA. 
Word BETA+4 Same as BETA+1. 
Word BETA+5 same as BETA+2., 


CHARGE: 2 MILLISECONDS. 


Remarks: ‘There are two types of divisional files, global access and 
restricted access. 


In global access, all users may access this divisional file, 
but only the users belonging to the owner division may 
change the status of this file. 


In restricted access, only the users belonging to the owner 
division may access this divisional file. Also, only the users] 
belonging to the owner division may change the status of the §[ 
file. 


9.2.9. GIVE TAPES TO CONTROLLEE 


THIS CALL GIVES A CONTROLLEE ACCESS TO A TAPE CREATED BY ITS CONTROLLER. 


FORMAT: 
KORD 0: 00000 00000 {004A AAAAA 
HHERE: 
AAAAAA [S$ THE ADDRESS OF WORD ALPHA. 
KORD ALPHA: LONNR ETURN OOOOB8 BBBBB 
WHERE: 
10 1S THE CODE FOR 'GIVE TAPES TO CONTROLLEE’. 
NN iS THE NUMBER OF TAPES GIVEN, 
RETURN IS AN ADDRESS, [F THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL WILL GE SENT TFG “RETURN. DF THE: .CALL. 1S SUCCESSFULLY 


COMPLETED, CONTROL KILL BE SENT TO 'RETURNGI’. 
BBBBBB [S$ THE ADDRESS OF THE FIRST RORD, BETA, OF THE NN TAPE [DENTIFICATIONS. 


KORD BETA: TAPE VAULT NUMBER (ASCII, RIGHT JUSTIFIED). 


Change 3: Dec. 14, 1973 
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WORD BETA+I: 
HHERE : 

MM 

ss 


MMSSO 00000 00000 00000 


1S THE MINUS AORD FOR THIS TAPE, 
1S FILLED IN (BY FROST) ON COMPLETION OF THE SYSTEM CALL, AS FOLLOKS: 


$$e00 
$$«O| 
$$*02 
$$#03 


NORMAL COMPLETION, 

MEANS THE TAPE IS NOT DEFINED, 

MEANS KRONG MINUS WORD, 

MEANS THE CONTROLLEE ALREADY GOHNS A PRIVATE TAPE IN THE MINUS WORD 
THAT THE CONTROLLER 1S TRYING TO USE TO GIVE THE TAPE, 
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9,2. CALLS TO FROST 


WORD BETA+2: SANE AS 3ETA 
BETAS: SAME AS SETA+! 


FOR SS > 00, CONTROL HILL GO TS ‘RETURN’; FOR SS « OO, CONTROL KILL GO T8 
"RETURNGL’, 


THE CONTROLLEE HILL GAIN ACCESS TO THE GIVEN TAPE IN THE SAME MINUS WORD NUMBER IN KHICH 
THE CONTROLLER OWNS THE TAPE. THE CONTROLLEE WILL NOT BE ALLOWED TS DESTROY THAT TAPE (AN 
$$«06 ERROR HILL BE RETJRNED == SEE PAGE 7), THE CONTROLLEE MAY CREATE A TAPE BY SOME 
OTHER NAME TN THE MINUS WORD IN HHICH THE PREVIOUS TAPE RAS GIVEN, WITH NO [LL EFPECTS ON 
THE CONTROLLER, 


CHARGE: 2 MILLISECONDS. 


eee FILE NAME, PROGRAM NAME, ACCOUNT NUMBER, cAND- DONATE TIME 


ee @e@eGeeesee ee eeaeeeeeeoeoe eweeeeaeaeweweeee fGeeeeewveoeoeeseeGeeeeeeeoeeoeeeeoeeeoeee &®oeoe ese © @ @ 


THIS CALL ALLONS ONE TO CHANGE THE NAME OF A FILE OR PROGRAM GR ODGNATE TIME TG ANOTHER 
USER OR TO CHANGE THE ACCOUNT NUMBER, 


FORMAT: 
KORD 0: 00000 00000 [004A AAAAA 
WHERE: 
AAAAAA IS THE ADDRESS OF HORD ALPHA, 
RORD ALPHA: §LINNR ETURN 0000B 88888 
WHERE: | 
i IS THE CODE FOR 'CHANGE FILE NAME’, 
NN INDICATES KHICH OPTION 1S DESIRED: 


NN©eQO CHANGE FILE NAME. 
NN«O! CHANGE PROBLEM NAME. 
NNsQ2 CHANGE ACCOUNT NUMBER, 
NNeO3S = =DONATE TIME, 

RETURN [S AN ADDRESS. {F THIS SYSTEM CALL WAS NOT SUCCESSFULLY COMPLETED, 
CONTROL RILL BE SENT TO ‘RETURN’, JF THE CALL IS SUCCESSFULLY 
COMPLETED, CONTROL WILL BE SENT TO 'RETURN#{’. 

BBBBBB IS THE ADDRESS OF WORD BETA, CONTAINING ADDITIONAL INFORMATION REQUIRED 
BY THE CALL. 


Changed: January 21, 1971 
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Fees CALLS TO FROST 


HORD BETA: NN «© 00: OLD FILE NAME (ASCII, RIGHT JUSTIFIED). 
NN «© OL; NEA PROGRAM NAME CASCI], RIGHT JUSTIFIED). 
NN «© O02; WERK ACCOUNT NUMBER (ASCIY, RIGHT JUSTIFIED). 
NN «© O03: DONOR USER NUMBER (ASCII, RIGHT JUSTIFIED), 


RORD BETA+!: NN © 00: NEW FILE NAME (ASCII, RIGHT JUSTIFIED). 
NN = Of: NOT USED. 
NN © 02: OLD ACCOUNT NUMBER (ASCII, RIGHT-JUSTIFIED stored by FROST), 
NN = 03: DONEE USER NUMBER (ASCII, RIGHT JUSTIFIED). | 


WORD BETA+2: KN «© 00: NOT USED. 
Nos Ol; OT USED. 
NN # O2: NOT USED. 
NN e O35; TIME TO BE DONATED (IN INTEGER MICROSECONDS). 
AN ERROR RETURN INDICATES THAT THE FILE JS NOT THERE OR THAT THERE IS A NAME OUPLICATION. 


CHARGES 2 MILLISECONDS. 


9.2010. GIVE UP PILE S2Ace 


Se @ ee Se esgeeeeseeesBDeeeeeee #2 8G & & &S 


THIS CALL ALLOWS ONE TO SHRINK THE SIZE GF A DISC FILE. 


FORMAT: 
WORD 0: 00000 00300 [004A AAnaAA 
RHERE: 
AAAAAA 1S THe ADDRESS OF WORD ALPHA, 
HORD ALPHA: 1200R ETJRN OOOOB BSBBB 
RHERE : | 


12 bo. ame CODE FOR “GIVE “UP FICE SPACE”. 

RETURN 1S AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL WILL BE-SENT TO "RETURN'.. TP “THE. CALL. 7S. SUCCESSFULLY 
COMPLETED, CONTROL WILL BE SENT TO ’RETURNGI’. 

BBBBBB iS THE ADDRESS OF A WORD, BETA, DEFINING THE FILE RHOSE LENGTH IS TO BE 
CHANGED. 


WORD BETA: NANE OF FILE (ASCII, RIGHT JUSTIFIED). 


' Change 2: Sept. 15, 1972 
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9.2. CALLS TO FROST 


HORD BETA+{:; 00880 00000 GO0Z2Z2 22222 


AHERE: 
$$ IS FILLED IN (BY FROST) ON COMPLETION OF THE SYSTEM CALL, AS FOLLOXS: 
$$#00 NORMAL COMPLETION. 
SS«Of THE NEH FILE LENGTH [S$ LARGER THAN THE OLD FILE LENGTH. 


$$«02 NAME NOT IN FILE INDEX, 
2Z...2 IS THE (USER SUPPLIED) LENGTH OF THE NEW FILE, ROUNDED UP TO THE NEAREST 
100 (3CTAL). 


IF SS « 00, CONTROL WILL GO TO ‘RETURN+I’. JF SS > OO, CONTROL HILL GO TS 
"RETURN’. | 


Charge=2 milliseconds. 


Note: If the file is a classified file at a level higher than P=2, the user's minus 
word will be changed to indicate a shorter length, but disk-file space is 
not released in the system's file index. The minus word will contain the 
shorter length until the controllee is dumped to disk; on subsequent 
reloads the minus word will contain the old, longer length. 


ooo @Ooweswe 2 Owe @bOwew® Gee eeae & & & 


IF, DURING THE COURSE O° AN EXECUTION, A PROBLEM PROGRAM REACHES A POINT XHEREIN IT NO 

LONGER NEEDS ALL OF THE CORE SPACE INITIALLY ALLOTTED TO JT, THE PROBLEM PROGRAM MAY 
SHRINK iTS OXN MEMORY Br DELETING THE UNUSED PORTION AT THE HIGH ADDRESS END. THIS CALL 
MAY ALSO BE USED TO INCREASE CORE STORAGE REQUIREMENTS. 


FORMAT: 
WURD 0: 00000 00900 [004A AAAAA 
RKHERE: 
AAAAAA 1S THe ADDRESS CF AGRD ALPHA, 
WORD ALPHA: L3NNR ETJRN COO0B BBBEB 
WHERE : 
ie TS. THe. “COGE Fear "ADJUST CORE SPACE”, 
NN INDICATES THE OPTION DESTRED. 
NN*«0Q0 MEANS ADJUST CORE SPACE, 


NNelQ MEANS LOAD THIS PROBLEM PROGRAM STARTING at THE high order 
ADDRESS, 

RETURN IS AN ADDRESS. IF THIS SYSTEM CALL WAS NOT SUCCESSFULLY COMPLETED, 
CONTROL WILL BE SENT TO ‘RETURN’, IF THE CALL IS SUCCESSFULLY 
COMPLETED, CONTROL HILL BE SENT TO 'RETURNeI’. : 

BSBBBB (NN*CO) JS THE ADDRESS OF HORD BETA, RHICH CONTAINS THE (INTEGER) SIZE 
OF TRE PROGRAM, 


Errata l 
December 3, 1969 
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9,2, CALLS TO FROST 


COME SPACE NAY HE ADJUSTED EITHEN UP OR DOWN, LIMITED Oy THE GIZE OF THE FILE (PHAT 16, 
THE CODE LENGTH MUST WE AT LEAGT 400 (OCTAL) LEGO THAN [TG O1GC FILE Gide), 


CHARGE, 2 MILLISECONDS TO INCREASE FIELD LENGTH, 
NO CHARGE TO DECREASE FIELD LENGTH, 


9.2.12. SEND A MESSAGE TO THE CONTROLLER 


THIS CALL MAY BE USED Bf A PROSLEN PROGRAM TO SEND A MESSAGE TO ITS CONTROLLER. To 
FACILITATE CONTROL BETKZEN A CONTROLLEE AND ITS CONTROLLER, THE ACT OF SENDING A MESSAGE 
TO A CONTROLLER ALSO SUSPENDS THE CONTROLLEE AND ACTIVATES THE CONTROLLER, UNLESS THE 
“CONTROLLER I$ A TELETYPE. 


FORMAT; 
KORD 0; 00000 00900 1004 AAAAA 
RHERE ; 
AAAAAA IS THE ADORESS OF WORD ALPHA, 


HORD ALPHA: 14NNR ETJRN COMMS BSBBs 
KHERE: 
14 1S THE CODE FOR ‘SEND «a MESSAGE TO THE CONTROLLER’. 
NN DETERMINES THE CPTJON TO Be TAKEN: 
NNe OQ SPECIFIES THE "REPLACE’ OPTION DESCRIBED BELOA, 
NNeQf SPECIE 'SS THE “NOTIFY’ OPTION DESCRIBED SELOA, 
NNet{Q Specifies the "Direct to Teletype and Notify" option 
described below. | >. F 
NN=12 Specifies the "Direct to Teletype and Replace" option 
| described below. 

Return is an address. If this system call has not successfully completed, 
control will be sent to 'return'. If the call is successfully 
completed, control will be sent to 'returntl'. 

MM is the number of main-frame words in the message (MM must never 
be greater than fifteen). 

BBBBBB is the address of word beta, the beginning of the message storage 

area. 


Errata 2 
March 9, 1970 
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9.2. CALLS TO FROST 


WORD BETA: ----~-- MESSAGE=ssecus 
BETAt1]: ------- MESSAGEs=24425 
BETA+14: ------- MESGACHSa=ae—u 


The message starting in beta may be up to 150 characters long. Transmission is 
terminated by the end-of-message character (EOM), 400204, or 150 characters, 
whichever occurs first. If an end-of-message is omitted, FROST will insert one at 
the end of the message. 


If the message is maximum length (currently 15, sixty-bit words) the FROST will 
insert the E.O.M. sentinel in the low order 18 bits of the 15th word. 


If the message is less than maximum length, FROST will add another word containing 
the E.O.M. sentinel in the high order 18 bits. 


Sending a message causes the system to copy the message from problem program core 
into a system buffer. Sending a message also starts the controller. 


There are three possible paths of communication between the controllee 
(requesting program) and the controller (destination of message.) 


Path 1 - There are no problem program controllers between the 
controllee and the teletype. 


Path 2 - There is at least one problem program, whose output by- 
pass is not set, between the controllee and the teletype. 


Path 3 - All problem program controllers between the controllee 
and the teletype have their output by-passes set. 


Buffer definition: 
1. Length of buffer is fifteen (15) words. 


2. Only one buffer available per suffix for teletype messages -- owned 
by the problem program closest to the teletype. 


3. Each problem program has only one buffer used for both input and output 
to either teletypes, controllers, controllees. 


Charge: 2 milliseconds if the message can be sent immediately 


Errata 1 
December 3, 1969 
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OPTION PATH 1 PATH 2 PATH 3 
| LOG OUT: LOG OUT LOG OUT: 
Error return Error return Error return 
NN = $1 
NOTIFY | LOG IN: — ; LOG IN: | LOG IN: 
If buffer full, If buffer fulli,| If buffer full, 
error return. error return error return. 
| LOG OUT: | LOG OUT: LOG OUT: 
NN = 1¢4 | Error return | Error return Error return 
NOTIFY AND | 
DIRECT TO 
TELETYPE 
| LOG IN: | | LOG IN: | LOG IN: 
If buffer full, If buffer full,| If buffer full, 
error return. error return. error return. 
|LOG OUT: | LOG OUT: | LOG OUT: | 
ee 60 | Always replace | Always replace | Always replace 
REPLACE message. message message 
|LOG IN: | LOG IN: | LOG IN: 
If buffer full, | If buffer full, If buffer full 
dump to disc dump to disc | dump to disc 
State = 14, untill State = 14 until] State = 14 until 
|_buffer empty. | buffer empty. | buffer empt 
LOG OUT: LOG OUT: | LOG OUT: 
NN = 12 Always replace Always replace | Always replace 
REPLACE AND message message | message 
DIRECT TO 
TELETYPE | 
| LOG IN: LOG IN: | LOG IN: 


If buffer full, 


dump to disc 


State = 14, until 


_buffer empty. _ 


If buffer full 
dump to disc 
State=14, until 
buffer empty 


it butter full, 
dump to disc 
State=14, unti 


i buffer empty. 


Errata 2 
October 1, 1970 
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9.2. CALLS TO FROST 
9.2.13. Send a Message to the Controllee 


this call is used to startup a controllee. The controller is suspended 
and the controllee activated. A message may be sent from the problem program 
(controller) to its controllee. 


Format: 
Word 0: 00000 00000 1004A AAAAA 


where: 
AAAAAA is the address of word ALPHA. 


Word ALPHA: 15ZZR ETURN CCMMB BBBBB 


where: 
15 is the code for ''send a message to the controllee." 
TZ represents the bits ONDDDD, 


where: N is the startup controllee option 
N=0 Startup controllee with message 
N=] Startup controllee without a message 
DDDD=00 Normal 


DDDD=01 Set input bypass. Messages from a controller will bypass 
this problem program and be given to the control lee. 


DDDD=02 Set output bypass. Messages from a controllee will bypass 
this problem program and be given to the controller. 


DDDD=03 Set input and output bypass. 


DDDD=10 Treat controller like a read only file (that is the controller 
of the controller becomes the controller of the controllee 
and any tapes belonging to the controller become controllee 
tapes). Any message of the controllers to the teletype which 
has not yet been output will be lost. 


Return is an address. If this system call was not successfully 
completed, control will be sent to ‘return’. If the call is 
successfully completed, control will be sent to ‘returntl’. 


. €C=00 Do not resume this problem program if the controllee suspends 
waiting for a message from controller. 
CC=OT Resume this problem program if the controllee suspends waiting 
for a message from controller and this program's input bypass 
is not on. 


MM is the number of main-frame words in the message (MM must never 
be greater than fifteen) 


BBBBBB is the address of word Beta, the beginning of the message 
Storage area. 


Changed: January 21, 1971 
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(Information deleted) 


Sending a message causes the system to copy the message from problem 
program core into a system buffer and to start the controllee. If 

the input bypass is set and the controller is running in the situation 
teletype-controller-controllee, the controllee will be started with a 
teletype message. 


Change 2: Sept. 15, 1972 
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9.2. CALLS TO FROST 


CHARGE: 2 MILLISECONDS. 


9.2.14. GET A MESSAGE FROM THE CONTROLLER 


THIS CALL MAY BE USED BY A PROBLEM PROGRAM TO GET A MESSAGE FROM JTS CONTROLLER, [F A 
MESSAGE IS KAITING, JT IS DELIVERED TO THE REQUESTING PROBLEM PROGRAM. IF THERE [5 NO 
MESSAGE WAITING, THE ‘NN’ OPTION FIELD KILL GE EXAMINED, AND THE INDICATED ACTION KILL 


TAKE PLACE, 


FORMAT: | 
HERD 0: 00600 00000 1004A AAAAA 
WHERE: 
AAAAAA 1S THE ADDRESS OF HORD ALPHA, 
KORD ALPHA: | {6NNR ETURN MMOOB 883938 
KHERE: 
16 IS THE CODE FOR 'GET A MESSAGE FROM THE CONTROLLER’. 
NN INDICATES THE SUSPEND MODE: 


NNe00 {F A MESSAGE iS NOT READY AND HALTING AT THE GNSTANT THIS CALL IS 
GIVEN, THE PROBLEM PRIGRAM iS SUSPENDED FROM CORE UNTIL SUCH TIME 
ead A MESSAGE [S READY. 

NiNsGi IF A MESSaGe IS NUT READY ft RAITING AT THE GNSTANT THIS CALL I§ 
GIVEN, CONTROL WILL BE RETURNED TO LOCATION ‘RETURN’ HKITH THE 
BUFFER UNTOUCHED. 

RETURN JS aN aDDRESS. IF THIS SYSTEM CALL HAS WOT SUCCESSFULLY COMPLETED, 
CONTROL HILL BE SENT TO ‘RETURN’, IF THE CALL $$ SUCCESSFULLY 
COMPLETED, CONTROL HILL BE SENT TS ‘'RETURNGI’, 

MM is the maximum number of main frame words to be 
delivered as a result of this call. If MM is zero, the 
entire message is delivered and may be up to 45 
main-frame words. 

BBBBBS IS THE ADDRESS OF HRD BETA, THE BEGINNING OF THE MESSAGE STORAGE AREA, 


GETTING A MESSAGE CAUSES THE SYSTEM TO COPY THE MESSAGE FROM A SYSTEM BUFFER INTO PROBLEM 
PROGRAM CORE. THE SYSTEM BUFFER IS DESTROYED. | 


CHARGE: 2 MILLISECONDS IF MESSAGE iS KAITING, 


Errata ] 
October 1, 1970 
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9.2, CALLS TO FROST 


9,2,18,. GOT A MEGSACE FROM THE CONTROLLEE 


- > @ th a i oo BS & & mw oe Bw Be we Bw kB wAeMRAm mw wD wh wh & h Om mw SB DW w om & 


This call may be used by a problem program to get a message from a controllee. 
If a message is waiting, it is delivered to the requesting problem program. If 
there iS no message waiting, a word of all sevens laa zero) or a word of all 
twos is delivered to the problem program in Beta, and the error return taken. 
The twos are aiven if this problem proaram was started up hecause it used ontion 
CC=01 on Frost Call 15, Send a Message to the Controllee. The sevens are given 
FORMAT: otherwise. 
WORD 0: 00000 00000 {004A AAAAA 

WHERE: 

AAAAAA JS THE ADDRESS OF WORD ALPHA, 


WORD ALPHA: 1700R ETURN MMOOB BBBBB 
WHERE: 
eo IS THE CODE FOR "GET A MESSAGE FROM THE CONTROLLEE’. 
MM IS THE MAXIMUM NUMBER CF MAIN FRAME HORDS TO BE DELIVERED AS A RESULT OF 


THIS CALL (MM MUST NEVER GE GREATER THAN FIFTEEN), 

RETURN [6 AN ADDRESS, TF THIS SYSTEM CALL WAS fOT SUCCESSFULLY COMPLETED, 
CONTROL HILL GO SENT TO 'RETURN', TPF THE CALL oS SUCCESSFULLY 
COMPLETED, CONTROL HILL GE SENT TO 'RETURNGI’, 

BBGGBB {5 THE ADDRESS OF HORD BETA, THE BEGINNING OF THE MESSAGE STORAGE ARCA, 


GETTING A MESSAGE CAUSES THE SYSTEM TO COPY THE MESSAGE FROM A SYSTEM BUFFER INTO PROBLEM 
PROGRAM CORE. THE SYSTEM BUFFER {S DESTROYED, 


CHARGE: 2 MILLISECONDS. 


9.2.16. GET SYMBOLS FROM THE CONTROLLER 


THIS CALL IS [DENTICAL TO 'GET A MESSAGE FROM THE CONTROLLER’, DESCRIBED ON PAGE 21, 
EXCEPT THAT THE MESSAGE [S DELIMITED [NTO RIGHT-JUSTIFIED SYMBOLS -(4)% ACCORDING TO 
CERTAIN RULES. THE SYMBOLS ARE PLACED IN SEPARATE SEQUENTIAL COMPUTER WORDS, 


FORMAT: 
WORD 0: 00000 00000 [004A AAAAA 
HHERE: 
AAAAAA [TS THE ADDRESS OF WORD ALPHA, 


e(4)e A SYMBOL 1S DEFINED TO BE LESS THAN ELEVEN CHARACTERS. 


Change 2: Sept. 15, 1972 


6600 SYSTEM CALLS AND 1/0 REQUESTS CIC-LTSS-9-E0.3 5/27/69 PAGE 23 
9.2. CALLS TO FROST 


HORD ALPHA: 2ZONNR ETURN MMDDB 83888 
HHERE: 
20 1S THE CODE FOR ‘GET SYMBOLS FROM THE CONTROLLER’. 
NN INDICATES THE SUSPEND MODE: 
NNeQOO =F SYMBOLS ARE NOT READY AND HAITING AT THE JNSTANT THIS CALL {§ 
GIVEN, THE PROBLEM PROGRAM 1S SUSPENDED FROM CORE UNTIL SUCH TIME 
THAT A MESSAGE JS READY, 
NNeO! IF SYMBOLS ARE NOT READY AND WAITING AT THE INSTANT THiS Cate f§ 
GIVEN, CONTROL HILL BE RETURNED TO LOCATION ‘RETURN’ ATH THE 
BUFFER UNTOUCHED. 
MM 1S THE MAXIMUM NUMBER OF MAIN FRAME HORDS TO BE DELIVERED AS A RESULT CF 
this call. If MM is zero all symbols will be delivered. 
The maximum is 150, 
RETURN IS AN ADDRESS. UF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL WILL BE SENT TO ‘RETURN’, JF THE CALL [S$ SUCCESSFULLY 
COMPLETED, CONTROL AILL BE SENT TO ‘RETURN+I’, 
DD INDICATES HHAT CHARACTERS ARE TO BE USED 4S SYMSOL SELIMITERS: 
DDe00 CAUSES SYMBOLS TO BE DELIMITED BY SPACES AND LINE SEPARATORS, 
DOeO! CAUSES SYMBOLS TO BE DELIMITED BY SPACE, LINE SEPARATOR, COMMA, 
PERL OD, SEMICOLON, LEFT PARENTHESIS, R}GHT PARENTHESIS, 


left bracket, and right bracket. | 


DD-04 causes symbols to be delimited by 6-bit ASCII charac- 
ters Specified in the Beta array (one delimiter right- 
adjusted per Beta word). There can be a maximum of 
10 delimiters, A Beta word which contains a negative 
integer ends the list. If no delimiters are set, only 
18-bit character strings beginning with an "at" (@) 
character (40 octal) are delimiters, These are always 
delimiters, 


BBBBBB IS THE ADDRESS CF HORD BETA, THE BEGINNING OF THE MESSAGE STORAGE & 
EACH INCOMING SYMBOL IS RIGHT JUSTIFIED INTO A SEPARATE KORD STARTIN 
HORD BETA, 


= 4 
Rew, 
~ a 
Ww oa 8 


GETTING A MESSAGE CAUSES THE SYSTEM TS COPY THE MESSAGE FROM A SYSTEM BUFFER INTO PREBLEM 
PROGRAM CORE. THE SYSTEM BUFFER IS DESTROYED. | 


DELINITERS ARE TREATED AS BLANKS, JN THE SENSE THAT THEY CAUSE PREVIOUS CONTIGUOUS 
NON-DELIMITER CHARACTERS TO BE STORED AS A SYMBOL, HOREVER, A N@N-BLANK DELIMITER CTF 
VSED) 1S STORED aS THE NEXT SEQUENTIAL. SYMBOL. MULTIPLE BLANKS ARE TREATED LIKE A SINGLE 
blank when blank is used as a delimiter, | ‘ 

ON A 'GET SYMBOLS’ CALL REQUESTING MORE SYMBS8LS THAN SENT, THE SYMBOL AFTER THE LAST 
SYMBCL SENT HILL BE RECEIVED AS 400204, 


THE "AT? CHARACTER (40 OCTAL) ALHAYS SIGNALS THE BEGINNING OF AN EJGHTEEN-BIT TTY-TRIG 
C40XXXX) IN THE EXTENDED ASCII CHARACTER SET x(5)x, 


CHARGE: 2 MILLISECONDS IF MESSAGE IS HAITING. 


&®@ @® 8 ® & @eee@eeaqae @ 


e(5)e SEE SECTION 3.3.1. 


Change 4: Jan, 29, 1974 
6600 SYSTEM CALLS AND 1/0 REQUESTS CIC-LTSS-9-ED.3 5/27/69 PAGE 24 


9,2, CALLS TO FROST 


9.2.17. GET SYMBOLS FROM THE CONTROLLEE 


THIS CALL IS SIMILAR TS 'GET A MESSAGE FROM THE CONTROLLEE', DESCRIBED SN PAGE 22, 
EXCEPT THAT THE MESSAGE 1S DELIMITED INTO RIGHTS JUSTIFIED SYMBOLS x(6)e ACCORDING TE 
CERTAIN RULES. THE SYMBOLS ARE PLACED IN SEPARATE SEQUENTIAL COMPUTER HERDS. JF THE 
SYMBOLS ARE NOT READY AND WAITING, THE ERROR RETURN WILL BE TAKEN with a word of either 
7*s or 2's stored in BETA (7's if the PP is running because of an interrupt 
from Teletype, and 2's if the PP is running becauSe its controllee 
suspended waiting for a message from controller), | 


BE STORED. 


FORMAT: 
HORD 0: 00000 00000 1004A AAAAA 
RKHERE: 
AAAAAA 1S TRE ADDRESS OF WORD ALPHA. 


RORD ALPHA: 2100R ETURN MNDDB BBBBS 
KHERE: 
re | 1S THE CODE FOR 'GET SYMBOLS FROM THE CONTROLLEE'. 
MN IS THE MAXIMUM NUMBER CF MAIN FRAME HORDS TO BE DELIVERED AS A RESULT OF 
| THIS CALL. If MM is zero, a maximum of 150 characters may 
be delivered. 


RETURN IS AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL KILL BE SENT TO ‘RETURN’. IF THE CALL JS SUCCESSFULLY 
COMPLETED, CONTROL KILL BE SENY TO °RETURNG{’. 

DD INDICATES KHAT CHARACTERS ARE TO BE USED AS SYMBOL DELIMITERS: 

DDe00 CAUSES SYMBOLS Td BE DELIMITED BY SPACES AND Line SEPARATERS, 


DD=01 Causes symbols to be delimited by space, line separator, 
comma, period, semicolon, left parenthesis, right 
parenthesis, left bracket, and right bracket. 


DD=04 Causes symbols to be delimited by 6-bit ASCII characters 
specified in the BETA array (one delimiter right-adjusted 
per BETA word). There can be a maximum of 10 | 
delimiters. A BETA word which contains a negative 
integer ends the list. If no delimiters are set, only 
18-bit character strings beginning with an ‘at’ (@) 
character (40 octal) are delimiters, These are 
always delimiters. 


BBBBBB IS THE ADDRESS CF HORD BETA, THE BEGINNING CF THE MESSAGE SvoRAGE AREA. 
EACH INCOMING SYMBOL IS RIGHT JUSTIFIED INTO A SEPARATE HORD STARTING at 
KORD BETA, | 


GETTING A MESSAGE CAUSES THE SYSTEM TO COPY THE NESSAGE FROM A SYSTEN BUFFER INTO PROBLEM 
PROGRAM CORE, THE SYSTEM BUFFER IS DESTROYED. 


THE “AT’ CHARACTER (40 OCTAL) ALKAYS SIGNALS THE BEGINNING OF AN EIGHTEEN-BIT TTY-TRIO 
(4OXXXX) IN THE EXTENDED ASCIT CHARACTER SET x(7)%, 


CHARGE: 2 MILLISECONDS JF SYMBOLS ARE KAITING. 


(62m A SYMBOL JS DEFINED TO BE LESS THAN ELEVEN CHARACTERS. 
we(7)e SEE SECTION 3,3, 1, 
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9.2, CALLS TO FROST 


9.2.18. INITIALIZE OR DISCONNECT A CONTROLLEE 


®©ae ee SSH 8G GOeeeoeweeevee @WDe@e*e Ve BveQOseoaoaseoanaawewoeedwewswa 


PAGE 25 


THIS CALL MAY BE USED BY A PROBLEM PROGRAM TO INITIALIZE OR DISCONNECT A CONTROLLEE. 


BEFORE A PROBLEM PROGRAM STARTS A CONTROLLEE, CERTAIN PARAMETERS MUST BE SET AND/OR 
VERIFIED. 
FORMAT: 
WORD 0: 00000 00000 {004A AAAAA 
WHERE: 
AAAAAA [S$ THE ADDRESS OF WORD ALPHA, 
KORD ALPHA: 22NNR ETURN C0008 88888 
WHERE: | 
22 1S THE CODE FOR "INITIALIZE OR DISCONNECT A CONTRSLLEE’. 
NN INDICATES KHETHER INITIALIZE OR DISCONNECT IS DESIRED. 
NN©00 INITIALIZE (ERROR IF A CONTROLLEE 1S ALREADY PRESENT). 
NNeOl DISCONNECT (ERROR [F THERE I$ NO SUCH CONTRSLLEE). 
NNsO2 [NITSALIZE A CONTRSLLEE AT A&A PRIORITY STHER THAN THE 
CONTROLLER'S, 
RETURN IS AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL RILL BE SENT TS ‘'RETURN’. JF THE CALL $S SUCCESSFULLY 
COMPLETED, CONTROL KILL BE SENT TO 'RETURNGI', 
BBBBBB IS THE ADDRESS OF A KORD, BETA, CONTAINING THE NAME OF THE PROBLEM YO BE 
STARTED. 
HORD BETA: CONTROLLEE FILE NAME CASCII, RIGHT JUSTIFIED). 


KORD BETA+I: OOXXX XXXTT TITTT TTTTT 
RHERE: 
XXXXXX 1S THE SIZE AT KHICH TO START THE CONTROLLEE. IF XXXXXX « 0, 
PALE CENGIR MINUS 256 <CECI. 


Siek 1S 


TT...7 US THE TIME LIMIT FOR THIS PROBLEM PROGRAM [N MICROSECONDS. NOTE THAT 
THIS DUES NOT CHANGE THE PRIGRITY. UF TT...T © 0, TiMe iS TAKEN FROM 


CONTROLCER’S TIME LIMIT, 


WORD BETAt2: THE FLOATING POINT PRICRITY VALUE TO BE USED FOR THE CONTROLLEE | 
[F "BETAt2" IS ZEROS, THE CONTROLLER'S PRISRITY HILL BE USED FOR 


NN « 02, 


TRE 


CONTROLLEE KITH NO INDICATION OF THIS FACT BEING GIVEN TO THE CONTROLLER. 
TF 'BETA+2° IS NOT FLOATING POINT, GR IS NEGATIVE, THE ERROR RETURN 


HiLL Be TAKEN. IF 'BETA+2" HAS A CHARACTERISTIC OF 1777 OR 3777, 
ERROR RETURN WILL BE TAKEN. 


THE 


Change 4: Jan, 29, 1974 
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2.2% CALLS TO FROST 


THIS CALL DOES NOT START THE CONTROLLEE, THE PROBLEM PROGRAM MUST SEND A MESSAGE TO THE 
CONTROLLEE TO START JT. AN ERROR RETURN AILL BE TAKEN JF THE FILE SIZE OF THE CONTRELLEE 
IS LESS THAN 401 (OCTAL] OR GREATER THAN 505,557 (OCTAL). 


CHARGE: 2 MILLISECONDS. 


Wecits NEUSE 


THIS CALL MAKES IT POSSIBLE FOR THE REQUESTING PROBLEM PROGRAM TO SEVER ITS CONNECTION 
WITH A DISC FILE OR SET OF DISC FILES HITHOUT AFFECTING THE STATUS OF THE FILE(S) [N 
QUESTION «(8) x, 


FORMAT: 
WORD 0: 00000 00000 1004A AAAAA 
WHERE: | 
AAAAAA [1S THE ADDRESS OF KORD ALPHA, 
WORD ALPHA: 235NNR ETURN 00008 88888 
WHERE: | 
23 1S THE CODE FOR 'CLOSE’. 
NN 1S THE NUMBER OF FILES REQUESTED. 
RETURN 1S AN ADDRESS. IF THIS SYSTEM CALL KAS NOT SUCCESSFULLY COMPLETED, 
CONTROL HILL BE SENT TO ‘RETURN’, IF THE CALL [S$ SUCCESSFULLY 
COMPLETED, CONTROL HILL BE SENT TO 'RETURNGI’, 
BBBBBB iS THE ADDRESS OF THE FIRST RKORD, BETA, OF THE NN (LESS THAN {7 DECIMAL) 
REQUESTS. 
KORD BETA: MMRRS $0000 00000 00000 
WHERE: | 
MM 1S THE MINUS HORD OF THE FILE TO BE CLOSED. 
RR INDICATES THE READ/KRITE STATUS: 


RR«Q0 NO CHANGE, 
RReO{ MAKE THIS FILE A READ ONLY FILE, STARTING NOR, 
RR-O2 MAKE THIS FILE A READ/HRITE FILE, STARTING NOK, 
RR=04 Make this file execute-only, now. 
3S 1S FILLED IN (BY FROST) ON COMPLETION OF THE SYSTEM CALL, AS FOLLOHS: 
$S*00 NORMAL COMPLETION, 
S$$s04 ACCESS DENIED. 


e@ ee oGooeoeoededesa® @®@ 


*(8)% COMPARE ‘DESTROY’, PAGE 7, 


Change 2: Sept. 15, 1972 
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9.2, CALLS TO FROST 


WORD BETA+!; SAME AS BETA 


IF RR «© O2 AND THE FILE IS PUBLIC, ACCESS HILL BE DENIED. 


UPON COMPLETION, ZEROES ARE PLACED IN THE CORRESPONDING MINUS WORDS, MEANING THAT THIS 
FILE HAS BEEN REMOVED FROM THE PROBLEM PROGRAM'S LIST OF INPUT/OUTPUT EQUIPMENT. 


CHARGES 2 MILLISECONDS, 


9.2.20. TIME LIMIT, USER NUMBER, BANK ACCOUNT, PRIORITY, ETC. 


@@nm @eEeeeeGeee eee eees &©eeece ve see &SeaeevewseeeeoeesPOeeaeswevveeeesi veevwet © 2 BS SG eS @ 


THIS CALL ALLOXS THE REQUESTING PROBLEM PROGRAM TO MODIFY JTS TIME LIMIT; TO GET {[T§ 
USER [DENTIFICATION NUMBER AND BANK ACCOUNT; TO CHANGE [TS PRIORITY; T@ Ger ITS 
CURRENT TIME LIMIT AND PRIORITY; TO GET THE PERCENTAGE TIME CHARGED; TO GET THE 
PROBLEM PROGRAM NAME AND FIELD LENGTH; OR TO GET THE DESCRIPTOR BLOCK AND USER BLOCK 


TABLES, 


FORMAT: 
HORD O: 00000 00000 1004A AAAAA 
RKHERE: 
AAAAAA 1S THE ADDRESS OF KORD ALPHA. 
Word ALPHA: 24NNR ETURN OO00B BBBBB 
where: 
24 is the code for this system call. 
NN indicates which option is desired: 
NN=00 means modify time limit. 
NN=Ol means get user identification number and current bank account. 
NN=02 means change priority. 
NN=03 means get time limit and priority. 
NN=04 means get percentage time charged. 
NN=05 means get problem program name and field length. 
NN=06 means get descriptor block and user block tables.* 
NN=I1 means get user number, current bank account, and division 
number. 
NN=15 means get controllee's name and field length. 
NN=16 means get bank-account table. 
NN=25 means get controller's name and field length. 
NN=26 means get file-index table. *” 
NN=33 means get account number, suffix if logged 


in, protection level, suffix if logged in or not, 


“See Chapter 2. 


ab wb 
id bed be 


see Appendix B for formats of these tables. 


Change 2: Sept. 15, 1972 
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NN=36 means get disk-map table. * 7 
NN=46 means get correspondence table, ~ 
RETURN is an address. If this system call was not 
successfully completed, control will be sent to 
"return," If the call is successfully completed, 
control will be sent to "return+1."' 
BBBBB is the address of a word, BETA, whose format is 
described below. 


“See Appendix B for formats of these tables. 


Change 2: Sept. 15, 1972 


6600 SYSTEM CALLS AND 1/0 REQUESTS  CIC-LTSS-9-ED.3 5/27/69 PAGE 28 


WORD BETA, 


NN e 00; 


NN « O4; 


NN = 05: 


NN = 06: 


NN=1 | 
NN=15 


NN=16 
NN=25 


NN=26 


9.2, CALLS TO FROST 


THE HER TENE WIMET, TN TNTEGER MICROSECONDS, FROM THe PROOLEM 
PROGRAM, 

FILLED IN BY FROST WITH THE RIGHT JUSTIFIED ASCII USER 
IDENTIFICATION NUMBER, | 

THE NEW PRIORITY, IN FLOATING POINT, PROVIDED BY THE PROBLEM 
PROGRAM. IF ZERG, NO CHANGE KILL BE EFFECTED. 

FILLED IN BY FROST HITH THE EXISTING TIME LIMIT, IN [NTEGER 
MICROSECONDS. 

FILLED IN BY FROST WHITH THE ASCII PERCENTAGE CHARGE DISTRIBUTION, 
NON-PRIGRITY REIGHTED, AS 

boXX:Y¥V¥i22 
WHERE: 

bb ARE THS BLANK CHARACTERS 

XX § THE PER CENT OF TOTAL TIME CHARGED FER CPU USAGE, 

YY JS THE PER CENT OF TOTAL TIME CHARGED FER 179, 

ZZ %JS THE PER CENT OF TOTAL TIME CHARGED FOR SYSTEM CALLS. 

VALUES IN THESE FIELDS KILL BE SET TO ZERO wdEN Tre CALL IS MADE, 
SO THAT A SUBSEQUENT CALL HILL REFLECT PERCENTAGES OF TIME USED 
SINCE THE LAST PREVIOUS CALL. THESE VALUES PERTAIN TO A GIVEN 
DESCRIPTOR BLOCK (1.E., A SINGLE PROBLEM PROGRAM: ONLY. | 
FILLED IN BY FROST RI TH THE RIGHT-JUSTIFIED aSCI] PROBLEM PRIGRAM 
NAME. 
PSINTS TO THE FIRST AORD ADSRESS OF A BUFFER. THIS SUFFER MUST 
BE 2300 (DECIMAL) KORDS IN LENGTH. AN ERROR RETURN !S$ GIVEN IF 
THE FIRST HORD ADDRESS PLUS 2500 (DECIMAL) EXCEEDS THE PROGRAM 
FIELD LENGTH, THE SYSTEM KILL RETURN TO THIS BUFFER THE 
FOLLORING: - 


Words 1-N - The descriptor block table 
(16 words/block) . 
Words N+] - A word of 2's: 2222...2. 


Words (N+2)-M - The user block table (7 words/block). 


Word M+] Rh WORDT 2°53 222cia2s 

NOTE: M, N are unknown, but M < 2300. 
same as NN=0]1. 
Filled in by FROST with controllee's name, ASCII right 
justified. 


first-word address of a 180;9-word 

buffer. 

filled in by FROST with controller's name, 
ACSII right justified. 

eee address of a buffer 435219 words 
ong. 
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NN=33 filled in by FROST. 
Format: XXCCS SODAA AAAAA AAAAA 
where: 

XX will contain the ASCII code for the 
caller's suffix if the teletype is logged 
in under the caller's suffix; otherwise 
it will be zero. | 

CC will contain the caller's protection 
level, an integer number 0-7. 

SS will contain the ASCII code for the 
caller's suffix (A, B, C, or D). 

D is the operating level of the machine 
(default level). 

AA will contain the ASCII code for the 


account number of the caller, 
NN=36 first-word address of a buffer 102419 words long. 
NN=46 _ first-word address of a buffer 28,9 words long. 


Word BETA+1: NN=00 _§ filled in by FROST with the value of the time limit, 
in integer microseconds, at the time this call was 
made (prior to installing the new time limit). 

NN=01 = filled in by FROST with the current value of the 
bank account, in integer microseconds. 

NN=02 = filled in by FROST with the existing priority, in 
floating point, at the time the call is made. 

NN=03 = filled in by FROST with the existing priority, in 
floating point, at the time the call is made. 

NN=04 _ filled in by FROST with the total number of 
integer microseconds used since the last previous 
call. This is the base of the percentages used in 
word BETA. 


Change 2: Sept. 15, 1972 
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NN=05 


NN=1 1] 
NN=15 


NN=25 


NN=26 


Word BETA+2: NN=1] 


9.2. CALLS TO FROST 


filled in by FROST with the binary field length of the 
File. 

same as NN=01. 

filled in by FROST with the binary field length of the 
controllee. | 


filled in by FROST with the binary field length of the 
controller. 


filled in by FROST with absolute first- 
word address of file-index table. 


filled in by FROST with the (6 bit binary) division 
number. 


Change 2: Sept. 15, 1972 
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9.2, CALLS TO FROST 


OPTICN NN © O2 HILL CAUSE THE PROBLEM PROGRAM TO BE DUMPED TO DISC AND QUEVED FOR RELOAD 
AT TRE NEK PRIGRITY. THE ERROR RETURN KILL BE TAKEN IF NN > O35, IF THE NEK PRIORITY JS 
NOT A POSITIVE FLOATING POINT NUMBER, OR JF THE NEK PRIORITY HAS A CHARACTERISTIC OF {777 


OR 3777, 


The format of the bank-account table (NN=16), for each word, is: 


USNO BANK] where USNO = binary user number (20 bits), 
DIV = division code (6 bits), and BANK = time remaining in bank account 


(34 bits). 
Change: 2 milliseconds, except for 1.2 seconds for NN=06. 
9.2.21. AUTOMATIC SUSPEND AND RESTART 


SeGeeoveceSeeooe eee Goes eG eee O28 2&8 G&S & GS 


THIS CALL SUSPENDS THE PROBLEM PROGRAM ISSUING THE CALL AND AUTOMATICALLY RESTARTS IT AT A 
LATER TIME. 


FORMAT: 
HORD 0: 00000 00000 {004A AAAAA 


WHERE: 
AAAAAA 1S THE ADDRESS OF RORD ALPHA, 


KORD ALPHA: 2500R ETURN 00008 BsSoB 
KHERE: 

25 1S THe COfE FOR “AUTOMATIC SUSPEND AND RESTART’. 

RETURN 1S AN ADDRESS. IF THIS SYSTEM CALL HAS NOT SUCCESSFULLY COMPLETED, 
CONTROL AILL SE SENT TO ‘RETURN’, IPF THE CALL JS SUCCESSFULLY 
COMPLETED, CONTROL KILL BE SENT TO 'RETURNGI’, 

BBBBBS IS THE ADDRESS OF A WORD, BETA, CONTAINING THE LENGTH OF TRE SUSPENSION, 
IN INTEGER MICROSECONDS., 


THE SUSPEND LENGTH MUST BE BETHEEN THIRTY SECONDS AND THIRTY MINUTES. The ERROR RETURN 
HILL BE TAKEN JF THE PROBLEM PROGRAM GANS A TAPE, OR HAS A CONTROLLER OTHER THAN TELETYPE, 


OR HAS A CONTROLLEE, 


AT THE TIME THIS CALL IS ISSUED, THE JOB KILL BE SUSPENDED FROM ALL OPERATION FOR THE 
PERIOD SPECIFIED, aND AILL Be IN STATE « 31, AT THE END OF THE SUSPENSION PERIOD, THE Jp 
WILL Be PUT INTO A STATE «© {! AND AILL BE ELIGIBLE TO RUN AGAIN. CENTROU KILL THEN Be 


SENT TO ‘RETURN#I’. 


CHARGE: 2 milliseconds plus load and dump charges of 64 milliseconds 
+ (4 microseconds * problem program field length) 
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9.2, CALLS TO FROST 


9.2.22. MESSAGE BYPASS -CONTRCL 


oe FOOSE SOeOaewseewvneoweeneeweese® eee & @ 


THIS CALL ALLOKS A PROBLEM PROGRAM TO TURN INPUT AND/OR SUTPUT BYPASSES GCN ER CFF. IF A 
PROBLEM PROGRAN’S OUTPUT BYPASS IS TURNED OFF, THEN IT HILL RECEIVE MESSAGES GENERATED 
BY [TS CONTROLLEE; IF [TS OUTPUT BYPASS 1S TURNED ON, THEN MESSAGES SENT BY {[T 
CONTROLLEE HILL BYPASS THIS PROBLEM PROGRAM AND GO TO THE NEXT HIGHER CONTROLLER PROBLEM 
PROGRAM RHOSE OUTPUT BYPASS 1S TURNED OFF. JF A&A PROBLEM PROGRAM'S INPUT BYPASS 15 
TURNED OFF, THEN IT WILL RECEIVE MESSAGES GENERATED BY ITS CONTROLLER; [F {TS INPUT 
BYPASS 1S TURNED ON, THEN MESSAGES SENT BY [TS CONTROLLER HILL BYPASS THIS PROBLEM PROGRAM 
AND GO TO THE NEXT LOWER CONTROLLEE WHOSE INPUT BYPASS IS TURNED OFF. 


FORMAT: 


WORD O: 00000 00000 10044 AAAAA 
WHERE: 
AAAAAA IS THE ADDRESS OF HORD ALPHA, 
RKORD ALPHA: 2Z6NNR ETURN JJMMO 00000 
WHERE: 
26 1S THE CODE FOR 'BYPASS CONTROL’. 
NN DETERMINES THE TYPE OF BYPASS: 


NNeGf REFERS TO INPUT BYPASS. 
NieQ2 REFERS TO GUTPUT BYPASS. 
NN«O3) REFERS TO BOTH INPUT AND SUTPUT BYPASSES, 
JJ DETERMINES THE NATURE OF THE BYPASS: 
JJeCO IMPLIES TURN OFF BYPASS, 
JJeO! IMPLIES TURN ON BYPASS. 
MM STANDS FOR PROBLEM PROGRAM, CONTROLLER, OR CONTROLLEE: 
MM<O{ REFERS TO PROBLEM PROGRAM, 
MM<O2 REFERS TO CONTROLLEE. 
MM«035 REFERS TS CONTROLLER. 


IF MM « O2 AND THERE IS NO CONTROLLEE, OR SF MM « O3 AND THERE IS NO CONTROLLER PROBLEM 
PROGRAM, CONTROL WILL BE SENT TO "RETURN’. 


THE "SEND MESSAGE TO CONTROLLEE’ x*(10)e SYSTEM CALL DIFFERS FROM THE ‘BYPASS 
CONTROL’ IN THAT ONCE THE FORMER HAS TURNED THE BYPASS ON, THERE [S NO WAY TO TURN [T 
OFF EXCEPT BY DISCONNECTING AND RE-INITIALIZING THE PROBLEM PROGRAM, 


CHARGE: 2 MILLISECONDS, 


e(1O)8 SEE PAGE 19, 


Changed: January 21, 1971 
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9.2.23. SEND A MESSAGE TO DEVICE 

This call allows a problem program to send messages to non- 
teletype remote devices (such as file transport, TMDS, and remote 
terminals) provided: (1) the FROST system has the remote machine in its 
remote machine number table, (2) the remote machine is not one of those 
under system control only, and (3) the access information level of the 
remote machine is higher than or equal to that of the user program. Buffer 
sizes of 0 to 512 60-bit words can be transferred. A 96-bit message header 
constructed by FROST (or the remote machine on input) precedes each buffer. 
It contains information necessary to route the message, and tells the 


destination what to do with it. 


Format: 
Word ZERO: 00000 00000 1004A AAAAA 
where: 
AAAAAA is the address of word ALPHA, 
Word ALPHA: 31INNR ETURN 0000B BBBBB 
where: 
31 is the code to ''send a message to device," 
NN indicates the suspend mode: 


NN=00 If the message can't be sent at this instant, 
control will be returned to location ''RETURN.'" 

NN=01 = If the message can't be sent at this instant, 
suspend the requesting problem program in 
state 22 until the message is sent. 

RETURN is an address. If this system call was not 
successfully completed, control will be sent to 
“RETURN." If the call is successfully completed, 
control will be sent to "RETURN + 1." 

BBBBBB _ is the address of Word BETA, the beginning of a 


two-word array. 


Changed: January 21, 1971 
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Word BETA: 00SSD DDDDD MMMMX XxXxxX 
where: 
SS is filled (by FROST) on completion of the 
system call, as follows: 
55=00 normal; message was copied into system 
buffer. 
55=01 when NN=00, and the preceding message to a 
device has not yet been sent from the system 
buffer to the device. 
55=02 User access is denied to this device. 
95=03 MMMM field error. 
9S=04 when NN=00, and the system output queue is too 
long for this device. 
DDDDDD  Machine-device identification number, 
MMMM is the number of main-frame words in the 
message. 


XXXXXX is the address of the beginning of the message. 


Word BETA+1: The low-order 16 bits contain message-header 
type-control information: 
bit zr? First Identifies this message as the first ofa 
sequence of messages. 
bit oo Last Identifies this message as the last ofa 
sequence of messages. 
13 


opk age Error If message can't reach its destination, it 
will be returned to the sender with the error 
bit on unless the error bit is already on, 
in which case the message is lost. 


bit pee Convert If zero, FROST will convert input teletype 


messages from 8- to 6-bit ASCII and output 
teletype messages from 6- to 8-bit ASCII 
only when the system provides this service 
for source and destination machines and when 


the message buffer is less than 16 60-bit words. 


Changed: January 21, 1971 
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bite oo = 
bits 2} 7 9! 
pit 2° 


Type 
Control 


Chain 


Defines kind of information in this message. 
Meaning depends on the type. 


The 96-bit header may be extended by setting 

the chain bit. Any additional header must occupy 
consecutive 48-bit bytes (left justified overlapping 
word boundaries) in the message buffer, The 2 

bit of each header byte is a chain bit. The header 
is terminated, and text begins at a zero chain 

bit. The number of words in the message required 
by this call is the total number of 60-bit words 

in the problem program's message buffer, 
including possible header extensions and 


message text. 


A message of zero length means only 


the 96-bit header is transmitted. 


Change 2: Sept. 15, 1972 
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9.2.24, GET A MESSAGE FROM DEVICE 


This call allows a problem program to receive messages from non- 
teletype remote devices. It is the input version of FROST call ''Send a Message 
to Device" and has the same limitations. The input messages are queued up 


and given to the user in order, one at a time. 


Format: 
Word ZERO: 00000 00000 1004A AAAAA 
Woere: 
AAAAAA _ is the address of word ALPHA 
Word ALPHA: 32NNE ETURN 00008 BBEBBEB 
where 32 is the code to get a message from device." 
NN indicates the suspend mode: 

NN=00 If there is no message waiting at 
this instant, control will be returned 
to location “RETURN,” 

NN=O1 If there is no message waiting at this 
instant, Suspend the requesting 
problem program in state 23/9): 

RETURN is an address. If this system call was not 
successfully completed, control will be sent 

to "RETURN." Ifthe call is successfully 

completed, control will be sent to RETURN + 1.” 

BBBBBB is the address of Word BETA, the beginning 
of a three-word array. 
Word BETA: O0OSSD DDDDD MMMMX XxXxxx 
where: 5S is filled (by FROST) on completion of the 


system call, as follows: 


95 =00 Normal return — a message from device was 
copied from a system buffer into the problem 
program, DDDDDD contains the machine de- 
vice identification number which sent the 
message. BETA + 2 contains the size of the 
message. No teletype message has been 


received, 


DDDDDD 


MMMM 


AX XXXK 


Word BETA+1: 


Word BETA+ 2: 
where: 
PPPPPP 


NNNN 


LLLLLL 


KKKK 


Change 2: Sept. 15, 1972 
Page 30e 
SS=01 when NN=00, and as yet no message has 


arrived, 

9S=03 normal return; a message has been 
received from the user's teletype. It can 
be picked up by issuing an appropriate 
'set symbols or get message from controller' 
FROST call. A message from device may 
or may not have been received and copied 
into the problem program, depending 
whether or not DDDDDD is non-zero, 

(filled in by FROST) machine-device identification 


number, 


is the maximum number of main-frame words to be 


delivered as a result of this call. 


is the address of the beginning of the message-storage 


area, 


The low-order 16 bits are filled in by FROST and 
will contain any message-header type-control 


information received, 


PPPPP PNNNN LLULL LKKKK 


(filled in by FROST) is the machine-device 
identification number associated with the next 


message in the queue, if there is one, 


(filled in by FROST) is the number of words in the 


message received from device DDDDDD. 


(filled in by FROST) is a flag which if nonzero, 
means an input message from the source-machine 
device-number, LLLLLL, was lost because the 


system-device input queue was too long, 


(filled in by FROST) is the size of the lost input 


message. 


Change 2: Sept. 15, 1972 
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9.3, CALLS TO CMPPY 


9.3.1. REQUEST TIME CLOCK 


@euwesegseveeeesexzeheuvpasveexeueseeuss 


THIS CALL ALLOWS ONE TO GET THE CONTENTS OF THE 6600 REAL TIME CLOCK, 


FORMAT: 
WORD 0: 00000 00000 UUOLA AAAAA 
WKHERE: 
UU INDICATES WHICH CLOCK IS REQUESTED: 


UU=00 means store the current microsecond charge 
(including the I/O, CPU, and system-call 
charges, non-priority-weighted) into location 
AAAAAA and return control for location 
AAAAAA+3, (The current microsecond charge 
is cleared every time the job leaves the 
alternator loop.) 


UUseO{ MEANS STORE THE CURRENT READING OF THE SIXTY-BIT CLOCK IN LOCATION 
AAAAAA AND TRANSFER CONTROL TS LOCATION AAAAAAt{. THE SIXTY-BIT 
CLOCK CONTAINS THe NUMBER OF ELAPSED MICROSECONDS SINCE JANUARY I, 
1965. 
UUe02 MEANS STORE THE CURRENT READING OF THE LRL MASTER COMPUTER CLOCK IN 
LOCATION AAAAAA AND TRANSFER CONTROL TO LOCATION AdaAdddrl, 
AAAAAA JS THE ADDRESS OF A PARTICULAR CORE LOCATION. 


THE FORMAT FOR THE LRL MASTER CLOCK (IN BITS) GS: 


CNNANNODDDOD CHHHHHHMMMMM CMMSSSSSSSLL CLLLLLLLLLLP QOOOOOITISIS 

HHERE: 

Cet MEANS THAT THE CLOCK IS CHANGING. 

PaC MEANS PORER FAILURE. 

NNNNN oS MONTHS. 

DODODD IS DAYS. 

HHRHHH TS ROURS. 

MYMMMMM TS MINUTES, 

Sodocso.-bS. SECCND Ss, 

LLieatk. TS NitbTSeCongs, 

PECTS TS THE ASCI] CHARACTER FOR THE MACHINE [DENTIFICATION (G6, L, M, OR NI, 


EXCEPT FOR THE MACHINE JOENTIFICATION AND THE C AND P BITS, THESE BITS CONTAIN A MODIFIED 
FORM OF BCD. EACH GROUP OF FOUR BITS, COUNTING FROM RIGHT TO LEFT, CAN CONTAIN THE VALUES 
0000 (0) TS 100!t (9). 


CHARGE: NONE. 
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9.3. CALLS TO CMPPY 


9.5.2. GIVE UP CPU -- NEXT TURN 


THE REQUESTING PROBLEM PRCGRAM HILL GET NO MORE CPU TIME UNTIL THE PROBLEM PROGRAN’S 
NEXT TURN IN THE ALTERNATOR LOOP. 


FORMAT: 
KORD 0: 00000 00000 O00ZA AAAAA 
WHERE: 
AAAAAA IS THE ADDRESS WHERE THE PROBLEM PROGRAM [S TO BE RESTARTED. 


CHARGE: NONE. 


9.3.3, GIVE UP CPU == 178 


SBaeeu teeseeeesepeaeaeueetb se @eeseue & & 


THE REQUESTING PROBLEM PROGRAM WILL GET NO MORE CPU TIME UNTIL EACH OF THE SPECIFIED INPUT 
OR OUTPUT JOBS HAS BEEN COMPLETED. 


GIVE UP CPU UNTIL ALL INPUT/OSUTPUT IS COMPLETE (KTC-KNOHLEGGE OF TOTAL COMPLETION). 


FORMAT: 
HORD 0: 00000 00000 OOL0A AAAAA 
WHERE: 
AAAAAA JS THE ADDRESS OF A PARTICULAR CORE LOCATION, WHEN ALL INPUT/OUTPUT FOR 

TH}S PRODLEM PROGRAM HAS FINISHED, THE PROGLEM PROGRAM HILL BE RESTARTED 
AT LOCATION AAAAAA, THIS CALL MIGHT BE USED AY THE END OF A PROBLEM 
PROGRAM WHEN THE PROBLEM PROGRAM MUST RAIT UNTIL ALL OUTPUT IS FINISHED 
BEFORE JT SIGNALS THAT IT HAS FINISHED. . 
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9.3. CALLS TO CMPPU 


GIVE UP CPU UNTIL CERTAIN INPUT/GUTPUT JS COMPLETE (KOC°KNOWLEDGE OF COMPLETION). 


FORMAT: 
HORD 0: 00000 00000 CCIOA AAAAA 
WHERE: 
cc 1S A NUMBER BETHEEN ONE AND FIFTEEN, AND IS THE IDENTIFICATION NUMBER 
DESCRIBED IN FIELD CCCC OF AN [OD x(t tds, 
AAAAAA {1S THE ADDRESS OF A PARTICULAR CORE LOCATION. KHEN ALL OUTSTANDING 
1OD°S WHITH THE {[DENTIFICATION NUMBER CC HAVE TERMINATED AND THE 
INTERRUPT ROUTINE FOR THE LAST SUCH 10D HAS FINISHED, CONTROL KILL BE 
SENT TO LOCATION AAAAAA. IF NO INTERRUPT ROUTINE HAS BEEN SPECIFIED, 
CONTROL IS SENT TO AAAAAA AFTER THE INPUT/OUTPUT JOBS IN OUESTION HAVE 
BEEN COMPLETED. IF A CONTINGENT [6D WAS SPECIFIED INSTEAD OF AN 
[INTERRUPT ROUTINE, IT WILL HAVE BEEN PICKED UP BY CMPPU JUST BEFORE 
TRANSFER TO AAAAAA, 


GIYE UP CPU UNTIL NEXT INPUT/OQUTPUT COMPLETION (KFC-KNOWLEDGE OF FIRST COMPLETION). 


FORMAT: | 
HORD 0: 00000 00000 40!10A AAAAA 
WHERE: 
AAAAAA IS THE ADDRESS OF A PARTICULAR CORE LOCATION. WHEN THE VERY NEXT 
INTERRUPT ROUTINE HAS FINISHED, THE PROBLEM PROGRAM HILL BE RESTARTED AT 
LOCATION AAAAAA, [F NS INTERRUPT ROUTINE HAS BEEN SPECIFIED, CONTROL [S$ 
SENT TO AAAAAA AFTER THE INPUT/OUTPUT VSB IN QUESTION HAS BEEN 
COMPLETED. IF A CONTINGENT [6D HAS SPECIFIED INSTEAD 6F AN INTERRUPT 
ROUTINE, IT WILL HAVE BEEN PICKED UP BY CMPPU JUST BEFSRE TRANSFER T6 
AAAAAA, 


CHARGE: NONE. 


@® @ @86 6 ® ® © ®e © © @ & 


x(11)x SEE SECTION 9.4.1, PAGE 36, 


Change 2: Sept. 15, 1972 
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Pace CALLS TO CMPPU 


9.35.4. RETURN FROM AN INTERRUPT ROUTINE 


THIS CALL IS FOR USE WHITH THE INTERRUPT OPTIONS OF INPUT/OUTPUT OPERATIONS. CONTROL FOR 
THE REQUESTING PROBLEM PROGRAM IS TRANSFERRED TO THE POINT OF INTERRUPTION AT THE TIME Cr 
THE INPUT/OUTPUT COMPLETION. ALL REGISTERS ARE RESET TO THEIR CONTENTS AT TIME OF 
INTERRUPTION, 


FORMAT: 
WORD 0: 00000 00000 00200 00000 


RETURN TO KHERE THE PROBLEN PROGRAM HAS AT TIME OF THE INPUT/OUTPUT INTERRUPT. 


CHARGE: NONE. 


Format: | | | | 
Word 0: 00000 00000 0021A AAAAA clears SCOPE flag 


Word 0: 00000 00000 0022A AAAAA ~— sets SCOPE flag 


This call sets the SCOPE flag and saves AAAAAA, Subsequent entries 
into the system when word one is nonzero (i.e., the standard method of 
issuing FROST I/O calls) will cause CMPPU to create a new exchange package 
with P-counter = AAAAAA, to store contents of word one into AAAAAA-1, - 
and to run this new exchange package (in the same manner as I/O interrupt 
calls, so that a return from interrupt is necessary to transfer control back 
to the SCOPE code). 

This call is intended to provide execution of SCOPE codes in the FROST 
system. (SCOPE system calls are passed via word one, instead of via word 
zero aS in FROST calls.) If the SCOPE flag is off, then when word one is 
nonzero CMPPU processes the call as a standard FROST I/O call. 


Change 2: Sept. 15, 1972 
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9.4. FORMAT FOR INPUT/OUTPUT REQUESTS 


AN INPUT/OUTPUT (179) JGB IS DESCRIBED BY A FOUR-KORD BLOCK IN A PROBLEM PROGRAM CALLED AN 
19D (INPUT/OUTPUT DESCRIPTOR). A DETAILED DESCRIPTION OF THE [6D FORMAT [S GIVEN BELGK, 


NORMALLY, ONCE AN 100 HAS BEEN SUBMITTED, A PROBLEM PROGRAM SHOULD NOT MODIFY THE {89 
VTE THE ThPuf Of OuTpUT JOU HAS DEEN COMPLETED, SUCH MODIFICATIONS MAY RESULT Jf 
PROALEM PROGRAM LikOGHS DUE TO TNCORRECT DATA TRANSMI SST ONS, 


Before submitting an IOD, a problem program should begin by checking the 4 
contents of relative word one (that is, word one of the problem program's own § 
memory). If the right-most twenty-four bits of word one are not zero, it ‘ 
means the previous IOD has not been picked up by the system. If the right- 
most twenty-four bits are zero it means the problem program is free to sub- 
mit an IOD (the entire contents of word one is set to zero by CMPPU when the 
IOD has been picked up). 


TO SUBMIT THE 10D, STORE THE FOLLOWING HORD IN RELATIVE HORD ONE: 


XXXXX XXXXX XXO0Z Ze222 
HHERE: 
XX,,.X MAY BE ANYTHING, 
22222 «1S THE ADDRESS OF THE FIRST WORD, SETA, OF THE 100 BEING SUBMITTED, 


THE FOLLOWING $$ A LIST OF AVAILABLE INPUT/GUTPUT PROGRAMS, RITH REFERENCES TO THE PAGES 
ON HHICH DETAILED INFORMATION MAY BE FOUND, 


AAAA PAGE NAME OF {/0 PROGRAM 

OC02 4i READ EVEN PARITY (BCD) TAPE. 

0606 ONE PROCESSOR BISC READ (CHANGED BY FROST TO 0412). 
0007 SNE PROCESSOR DISC KRITE (CHANGED BY FROST TO O413). 
0014 DISPLAY ON dd80. 

0015 42 ART TE EVEN PARITY (BCD) TAPE, 

0016 42 SKIP TAPE RECORDS, 

0017 42 Display on G machine scopes. 

0025 42 Read/write central memory. 

C077 42 ILLEGAL, 

0410 43 READ ODD PARITY (BINARY) TAPE, 

O4i 1 44 ARRIVE ODD PARITY (BINARY) TAPE, 

0412 a DISC READ. 

0415 45 OSC HRI TE 

2000 46 READ TAPE UNIT STATUS. 

2001 46 REKIND, 

2002 46 REWIND UNLOAD. 

2005 fy RKRITE FILEMARK, 

2010 47 St. DENSITY: 70-200 BPI. 

2ott 47 Se GENS bit 90) 556. BP i. 


20lg | 47 SET DENSITY TO 800 BPI. 


Change 2: Sept. 15; 297fe 
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9.4, FORMAT FOR JNPUT/OUTPUT REQUESTS 


9.4.1. FORMAT OF AN JOD (BINARY) 


SSvde SVveBewVveaeseBdoewe se @®seeseoevueves wees 


ZETA | 
AAAAAAAAAAAA RRVH--HWDDDD LEEEE---¢CCC 0 === anagel acer wananel 
ZETA 
U-SSSSSSSSSS SBBBBBBBBEBB «------ -- eee XXXXXXXXXXKX XXXXXXXAXXXX 
ZETAt2 


666666666666 666666666666 “VYYYYYYVYYYY YUYYY Yc ccad PEPE OPEC LOS 4 


ZETAe3 
PRREEFRRREFE JK-ecQ0LUTs! Oepeereneen’ NQ--°P MMMMMM MMMMMNAMMMMM 


FIELD CONTENT, MEANING, AND/OR USE 


A. TYPE OF JOB. EACH 1/6 PROGRAM (HRITE TAPE, READ CARDS, DISPLAY, ...3 IS ASSIGNED 
A JOB NUMBER. THIS FIELD SPECIFIES AHICH (/0 PROGRAM IS TO BE used. SEE THE 
DESCRIPTION OF THE INDIVIDUAL I/93 PROGRAMS IN SECTIONS 9.5.1 - 9.5.16 (PAGES 41 
=) 41). 


B. ADVANCED BY ONE EACH TIME THE 16D JS COMPLETED. THE [/08 MECHANISM DOES NOT 
EXAMINE THIS FIELD. A TWELVE BIT ONE’S COMPLEMENT (END AROUND CARRY) ADDITION 
1S PERFORMED. 


C. LOD IDENTIFICATION NUMBER ASSIGNED BY THE PROBLEM PROGRAM, {TT {5S USED IN 
CONNECTION RITH THE "GIVE UP CPU UNTIL 170 1S COMPLETED’ SYSTEM CaLL (SECTION 
9.3.3, PAGE 32). THE CONVENTION {[S THAT EVERY 100 KHOSE CCCC (BINARY) FIELD [S$ 
EQUAL TO THE CC (OCTAL) FIELD OF THE “GIVE UP CPU’ SYSTEM CALL MUST TERMINATE 
BEFORE THE 'GIVE UP CPU’ IS SATISFIED AND THE PROBLEM PROGRAM JS RESUMED. 


D. MINUS-HORD DESIGNATION, INDICATES WHICH MINUS HORD CONTAINS THE DESCRIPTION OF 
THE $70 DEVICE USED IN THIS IOD. 


Es RESERVED FOR FUTURE USE. 
es ERROR MESSAGE, IF THE 1/8 OPERATION KAS COMPLETELY TROUBLE FREE, THIS FIELD WILL 


CONTAIN ZERO. JF THERE KAS AN ERROR JN THE J/0 OPERATION A MESSAGE WILL BE 
STORED HERE *({2) x, 


e(i2)8 SEE SECTION 9.6.2, PAGE 48, 


Change 2: Sept. 15, 1972 
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9.4, FORMAT FOR INPUT/OUTPUT REQUESTS 


G. IF THE 1/0 DEVICE IS A DISC, THIS IS THE FIRST DISC HOND ADDRESS FOR THE oDIse 
OPERATION. IF THE DEVICE IS NOT A DISC, THIS FIELD TAKES ON VARIOUS MEANINGS FOR 
EACH DEVICE AND 1S DESCRIBED INDIVIDUALLY FOR EACH [1/06 PROGRAM. JF THIS FIELD {S$ 
NOT SPECIFICALLY ASKED FOR BY THE 1/0 PROGRAM THE PROBLEM PROGRAM MAY USE IT T6 
STORE ANY DESIRED INFORMATION. 
H. Used by the system during a tape rewind. Must not be used by a problem 
program or altered between issuing a rewind IOD and completionof that IOD. 
1. THIS FIELD 1S USED FOR ONE OF THREE PURPOSES: 
{. TO SPECIFY THE LOCATION OF THE PROGRAM'S INTERRUPT ROUTINE. 
2. TO SPECIFY THE LOCATION OF AN [0D TO SE EXAMINED AND PROCESSED ONLY AFTER 
THIS {0D HAS BEEN COMPLETED. THIS ALLERS THE SIMPLE CONTINGENCY OF ONE [7/6 
JOB ON ANOTHER RITHOUT REQUIRING CPU-CODED INTERRUPT ROUTINES. SEVERAL 
TOo"'S MAY BE CHAINED TOGETHER THROUGH THE [-FIELD. THE (Nef) -ST 16D WILL 
not be issued until the N-th IOD has been processed 
and completed. 
3. TO SPECIFY THAT NO ACTION I$ TO BE TAKEN RHEN THIS 16D [S$ COMPLETED. IN 
THIS CASE THE FIELD MUST BE VOID. 


J. IF THIS BIT IS A GNE AND THE J-FIELD IS NOT ZERO, THEN [ [TS TAKEN TS CONTAIN THE 
ADDRESS OF A CONTINGENT 16D, CTHERHISE, [ JS THE ADDRESS Cr AN INTERRUPT 
ROUTINE. 


K. IF THIS BIT IS A ONE, ONCE THE INTERRUPT ROUTINE (SPECIFIED 8Y THE  IoFIELD) FOR 
THIS [9D HAS BEEN ENTERED, ALL INTERRUPTS CAUSED BY OTKER [00'S FOR THIS 
PROBLEM PROGRAM WILL BE INHIBITED UNTIL THE END OF THE INTERRUPT ROUTINE FER THIS 
TOD. 


bs IF THIS BIT IS A ONE, THE TAPE HILL NOT BE ERASED ON A BAD TAPE ARITE. 


THIS FIELD IS USED TO SPECIFY ERROR CONTINGENCIES IN THREE HAYS: 
vs TO SPECIFY THE LOCATION OF A PROGRAM'S ERROR ROUTINE. 
2: TO SPECIFY THE LOCATION OF A CONTINGENT [0D TO BE EXECUTED IN CASE OF AN 


ERROR. 
as IF VOID, THIS FIELD SPECIFIES NO ACTION. 


N, 1F THIS BIT [IS A ONE AND THE M-FIELD IS NOT ZERO, THEN M [S TAKEN TO CONTAIN THE 
ADDRESS OF A CONTINGENT 100. 


Q, IF THIS BIT IS A ONE, ONCE THE ERROR INTERRUPT ROUTINE (SPECIFIED BY THE M-F°"LD) 
FOR THIS [00 HAS BEEN ENTERED, ALL INTERRUPTS CAUSED BY OTHER [60'S FOR THIS 
PROBLEM PROGRAM KILL BE INHIBITED UNTIL THE END OF THE INTERRUPT ROUTINE FOR THIS 
100. 


P, =0 means problem terminated on a fatal I/O error, 
=1 means the user gets control if there is a fatal I/O 


error. 


Q, IF THIS 1S A BCD TAPE OUTPUT 16D, THIS BIT 1S COMPLEMENTED RHEN THE DATA HAS BEEN 
PICKED UP FROM THE PROBLEM PROGRAM'S MEMORY. 
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9.4, FORMAT FOR |NPUT/GUTPUT REQUESTS 


R. THIS FIELD JS ONLY USED RITH DISC KRITE [0D'S. IF THE INITIAL ADDRESS AND/OR 
THE FINAL ADDRESS OF A DISC HRITE [0D IS NOT A MULTIPLE OF {CO (OCTALi, THE DISC 
HRITE PROGRAMS MUST READ THE PARTIAL SECTOR(S), INSERT THE NeW DATA, THEN WRITE 
BOTH THE OLD AND NEK DATA INTO THE PARTIAL SECTOR(S). JF IT IS KNOKN THAT THE 
UNREFERENCED PORTION(S) OF THE PARTIAL SECTOR(S) NEED NOT BE PRESERVED, THE 
READING STEP MAY BE BYPASSED AND THEREBY SPEED THE WRITING PROCESS. 

RReOO MEANS PRESERVE Tet UNREFERENCED PORTIONS OF TRE FIRST AND LAST 
SECTORS SPECIFIED TN Tays. DISC ARITE 100, 

RR«Ol MEANS PRESERVE THE UNREFERENCED PORTION OF THE FIRST SECTOR 
SPECIFICD IN THIS. DISC ARLTE 100. 

RRefO MEAN PRESERVE THE UNREFERENCED PORTION OF THE LAST SECTCR SPECIFIED 
EN. THIS. OTSC RRI Te 100. 

RRe{{ MEANS DO NOT PRESERVE THE UNREFERENCED PORTIONS OF EITHER THE FIRST 
CR LAST SECTORS SPECIFIED IN THIS DISC KRITE OD. 


3. PROGRAMMER INFORMATION, THIS INFORMATION RILL BE RETURNED IN REGISTER AO AT THE 
TIME OF THE EOP INTERRUPT AND/CR ERROR INTERRUPT, THIS COULD BE UTILIZED IN A 
GENERAL -INTERRUPT ROUTINE, 


t, THIS FIELD MAY BE USED TO SPECIFY THE ADDRESS OF ANSTHER [6D wHICH {IS TO BE 
SUBMITTED AT THE SAME TIME AS THIS ONE. THIS FIELD PERMITS A CHAIN SF $8D°S Td 
BE ISSUED. THIS CHAIN DIFFERS FROM AN [-FIELD CHAIN IN THAT & T-FIELD IS NOT 
NECESSARILY AN ORDERED CHAIN. [08D'S FOR THE SAME DEVICE ARE PROCESSED IN THE 


order received, but CMPPU processes the totality of devices 
Specified in a manner convenient to CMPPU. 


NOTE: ANY JOD CHAIN MAY: 
ie BE INITIATED BY AN J-FIELD OR A T-FIELD AND 
Fos CONTAIN A MIXTURE OF BOTH [-FIELD AND TeFTELD CHAINS. 


Active bit. This bit is cleared by CMPPU when the job is completed. 
If the programmer wants to use this bit, it must be set before the IOD 
is submitted. 


Y, THIS FIELD 1S ONLY USED RITH DISC WRITE [0D'S. RHEN THIS BIT 1S A ONt, THE PPV 
HILL KRITE A SPECIFIED TRELVE-BIT DISC PATTERN IN A SPECIFIED DISC FILE. THERE 
1S A SPECIAL FORMAT FOR THE THIRD KORD OF THE 10D IN THIS CASE; SEE SECTION 
9.5.9, PAGE 45, FOR FURTHER REMARKS, 

K. THIS BIT IS FOR SYSTEM PURPOSES AND MUST NOT BE USED BY A PROBLEM PROGRAM, 


X. MAY CONTAIN PARAMETERS RETURNED BY SLAVE PROGRAMS TO THE PROBLEM PROGRAM UPON 
COMPLETION CF THE JOB. 


%; SPECIFIES SIZE OF CENTRAL MEMORY BUFFER, 
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9.4. FORMAT FOR INPUT/OUTPUT REQUESTS 


a SPECIFIES LOCATION OF CENTRAL MEMORY BUFFER, 


IY HILL BE NOTED THAT AN [OD MAKES NO DIRECT REFERENCE TO AN 170 DEVICE, THE REASON FOR 
THIS I$ THAT IF A PROGRAM COULD REFER DIRECTLY TO AN [70 DEVICE, IT KOULD BE POSSIBLE FOR 
ONE PROGRAN TO INTERFERE RITH ANGTHER (BY RRITING (YN THE OTHER'S DiSe FILE, FOR 
EXAMPLE). 


TO GET AROUND THIS DIFFICULTY, THERE IS ASSOCIATED WITH EVERY PROBLEM PROGRAN A BLOCK OF 
WORDS WHICH IS GUTSIDE THE PROGRAM'S MEMORY BIUNDS AND THUS NOT QIRECTLY ACCESSIBLE TO 
THE PROGRAM, FOR CONVENIENCE, THIS BLOCK SF WORDS INMEDIATELY PRECEDES THE PRUGRAM JN 
CORE. HENCE, HE CALL THIS BLOCK OF ACRDS THE PROGRAM’S "MINUS KORDS’. 
RHEN A PROBLEM PROGRAM DESIRES TO USE AN INPUT/OUTPUT DEVICE, IT MUST REQUEST THE DEVICE 
FROM FROST AND SPECIFY & MINUS KORD TO BE ASSOCIATED WITH THAT DEVICE. UF TRE DEVICE [S$ 
AVAILABLE TO THE REQUESTING PROGRAM, FROST WiLL STORE INFORMATION AHICH DESCRIBES THE 
DEVICE IN THE MINUS WORD. THEREAFTER, WHEN THE PROBLEM PROGRAM AISHES TS USE THE DEVICE, 
IT HILL REFER IN TRE [OD TO THE APPROPRIATE MINUS HORD. THE PPU CONCERNCD RITH THE 
EXECUTION OF THE JOB HILL LOOK AT THE MINUS KORD TS SEE HICH DEVICE i$ TO BE USED. THUS, 
FOR THE PROBLEM PROGRAMMER, THE MINUS KORD NUMBER BECOMES A SYMBOLIC NAME FOR THE [7/98 
VEYECE. 


HITH SEVERAL PROGRAMS IN THE ALTERNATOR LOOP AT ONE TIME, CONFLICTING DEMANDS F@R USE OF 
THE 1/0 CHANNELS WILL ARISE, CMPPU, THEREFORE, MUST SCHEDULE [70 JOBS SO THAT CONFLICTS 
ARE AVOIDED. 


FSR NON-DISC 1/8, THE SCHEDULING IS VERY SIMPLE. FOR EACH NON-DISC CHANNEL CMPPU HILL 
MAINTAIN A LIST OF vOBS TO BE EXECUTED. EACH 10D [S PUT AT THE END SF THE LIST RHEN IT IS 
SUBMITTED. HHEN A CHANNEL BECSMES FREE, CMPPU HILL ASSIGN SLAVE PPU’S T8 D9 THE FIRST 
JOB IN THE LIST FOR THAT CHANNEL (PROVIDED THAT ENSUGH FREE PPU'S ARE AVAILABLE). 


THIS MANNER OF SCHEDULING HOULD, HOKEVER, LEAD TO EXTREMELY INEFFICIENT USE OF THE DISCS, 
SINCE HEAD MOTION IS QUITE SLOW (195-260 MILLISECONDS), FOR THIS REASON, TRE LIST OF 
JOBS FOR EACH DISC CHANNEL JS ORDERED ACCORDING TO THE HEAD POSITION KHERE THE vO8 16 TC 
BE STARTED, ONCE THE HEADS ARE AT A GIVEN POSITION AND ARE PROCEEDING {N A GIVEN 
DIRECTION, ALL JOBS IN THAT DIRECTION (FROM THE CLOSEST TO THE FARTHEST) ARE EXECUTED 
BEFORE THE HEADS CHANGE DIRECTION, THIS HAS THE EFFECT OF ELIMINATING MUCK UNNECESSARY 
HEAD MOTION, 
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9.4, FORMAT FOR INPUT/OUTPUT REQUESTS 


LY MAY BO A SLIGHT INCONVENIENCE FO THE PROGRAMHER THAT DISC JONG ARE NOT NECKSEARILY 
EXECUTED IN THE ORDER IN WHICH THEY ARE SUQMITTED, GUT THIS CONSIDERATION {8 FAR 
OUTWEIGHED BY THE NECESSITY OF AVOIDING INEFFICIENT USE OF THE DISCS. 


HITH SEVERAL PROGRAMS SHARING THE DISCS, IT-1S NOT POSSIBLE FOR A PROGRAM TO REQUEST HEAD 
MOTION AND LATER REQUEST TO READ OR WRITE AND EXPECT THE HEADS TO BE IN THE PROPER 
POSITION, SINCE ALL DISC READ-AND-HRITE REQUESTS IMPLICITLY CONTAIN HEAD POSITION 
INFORMATION, IT IS NOT A HARDSHIP ON A PROBLEM PROGRAM IF THE HEADS ARE NOT IN POSITION 
WHEN A READ OR WRITE REQUEST IS MADE. ~ 


CMPPU determines whether one or two PPU's are assigned to a 
particular I/O request. One PPU is assigned to disk requests if the record 
comprises less than or exactly one sector and lies within one sector; other- 
wise two PPU's are assigned, (One sector is 6419 sixty-bit words. ) 

One PPU is assigned to binary tape read or write requests if the 
record comprises 512 or fewer control words; otherwise two PPU's are 
assigned. All tape function requests are assigned one PPU (e.g., rewind, 
space forward, etc.). BCD read or write tape requests are always assigned 
one PPU and accept a maximum record of 7202 characters. 

Requests for dd80 are always assigned one PPU. 


Errata | 
October 1, 1970 
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9.8.1, READ EVEN-PARITY (BCD) TAPE 


AAAA » 0002 READ EVEN PARITY (OCD) TAPE 

ONE ENTIRE RECORD IS READ EACH TIME THIS 1/0 PROGRAM IS USED. WHEN THE $00 1S COMPLETED, 
THE X-FIELD OF THE 10D HILL CONTAIN THE NUMBER OF THELVE-BIT BYTES (THAT 1S, THE NUMBER OF 
PPU RORDS) WHICH RKERE TRANSMITTED TO CENTRAL MEMORY. 

FIELD Y OF THE 10D SPECIFIES THE BUFFER LENGTH, THIS LENGTH IS INTERPRETED AS AN UPPER 
LIMIT ON THE NUMBER OF HORDS TO SE READ. THIS UPPER LIMIT HILL NEVER BE EXCEEDED BY THE 
1/0 PROGRAM. THE MAXIMUM ALLOHABLE UPPER LIMIT 1S 7202 CHARACTERS. 


[IF 'R' REPRESENTS THE NUMBER OF HORDS ACTUALLY IN A RECORD, ONE OF THREE CASES CAN 
RESULT: 


1) H« (FIELD Y}, AND Sek [S IN FIELD X. 
2) W< (FIELD Y), AND 58H IS IN FIELD X, 
3) W> (FIELD Y), AND S#(FSELD ¥} 3S IN FIELD X. 


IN CASE 3, AN ERROR WILL BE SET INDICATING THAT THE BUFFER HAS NOT LARGE ENOUGH, 


Pare DISPLAY ON DD80 


ee ee eeSseecwewet 28 &€ e282 88 & EG & G&S G 


AAAA «= OO14 DISPLAY ON 480 


FIELD G OF THE 16D IS OF THE FORM: 000000 O0000T PPPPPP PPPPPP 


WHERE; 
T IS THE TUBE ADDRESS AND 1S SET AT THE BEGINNING OF THE OUTPUT DATA. 
Tad MEANS DO NOT CHANGE TUBE ADDRESS. 
Tel MEANS SET THE TUBE ADDRESS FOR THE FIVE-INCH PRECISION TUBE ONLY. 
Te2 MEANS SET THE TUBE ADDRESS FOR THE VISUAL TUBE ONLY. 
Ted MEANS SET THE TUBE ADDRESS FOR BOTH TUBES. 
PP,..P 1S THE NUMBER OF PPU HORDS-TO BE SENT TO THE dd80. IF THE Y FIELD 


OF THE [0D 1S GREATER THAN 600 DECIMAL, PP...P IS IGNORED AND THE Y 
FIELD I$ USED AS THE NUMBER OF PPU HORDS TO BE SENT TO THE dd80. 


The errors returned in the F field are: 
0001 - DD80 not ready 
0002 - DD80 in manual 
0004 - Y field zero or too large or illegal DD80 word 


0010 - DD80 film jam 
0012 - DD80 Camera hung 
0020 - DD80 film low 
0100 - Channel failure 
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9.5.3. WRITE EVEN-PARITY (BCD) TAPE 


AAAA «= 0015 WRITE EVEN-PARITY (BCD) TAPE 


[IF FIELD G OF THE [6D 1S ZERO, THE NUMBER OF SIXTY-BIT WORDS TO BE WRITTEN IS TAKEN FROM 
FIELD Y, IF FIELD G OF THE 10D IS NOT ZERO, THE NUMBER OF TRELVE-BIT WORDS TO GE ARITTEN 
IS TAKEN FROM FIELD G. FIELD G MUST NOT EXCEED FIVE TIMES FIELD Y. THE MAXIMUM BUFFER 
SIZE 1S 7202 CHARACTERS. 


[F A BAD SPOT TS ENCOUNTERED, THE RECORD KILL SE REXRITTEN UP TO SEVEN TIMES. IF TRIS 
FAILS AND THE L BIT SF THE [00 IS ZERO, THEN ENQUGH TAPE HILL BE ERASED TS PREIDUCE AN 
ERROR-FREE KRITE. Ir, HOWEVER, A PARITY-FREE HRITE [S NOT EXECUTED AFTER A REASONABLE 
NUMBER OF TRIES (AT PRESENT, 105). IF THE TAPE IS NON-ERASABLE, OR JF THE END-OF-TAPE [§ 
PASSED, THEN A PARI TY-ERROR/END-OF-TAPE (0012) HILL BE STORED IN THE F FIELD OF THE JOD. 
AN END-OFeFILE KILL BE HRITTEN ON THE TAPE AND THE TAPE WILL BE BACKSPACED OYER THE 
END-OF-FILE, NOTE THAT THIS JS THE ONLY PARITY RETURNED HHEN L « O. 


9.5.4. SKIP RECORDS 


AAAA = 0016 SKIP N RECORDS 

G « OONNNNNN « N RECORDS BACKWARDS. (MAXIMUM No @ 377777 COCTAL) «© [31071 (DECIMAL) ) 
Go @ 40NNANNN © N RECORDS FORAARDS. MAXTMUM No « 377777 COCTAL) «© (35107! (SECIMAL)) 
G * 6OXXXXXX = SKIP FORAARD TO END-CF-FILE. xX IS IGNORED. 

G = 7OXXXXXX « SKIP BACKHARD TO END-OF-FILE. xX {S IGNORED. 


Note: This routine will return an error (for all four cases) if a filemark 
or end-of-tape or load point is encountered while skipping. Thus search 
filemark may be programmed by requesting the PPU to skip a large number of 
records and then recognizing the filemark error. 


Gn a skip records the number of records actually skipped (up to and 
including the filemark or end-of-tape or load point) will be stored in the 
X field of the IOD at completion of the operation. 


9,5.4(A). Display on G Machine Scopes 


AAAA = 0017 Y=size of user's buffer, Z=location of user's buffer (see 
| Paul Lund for details). 


9,5.4(B). Read/Write Central Memory 


AAAA-0025 D=0 means read, D=1 means write. Gis the absolute 
address in central memory, Y is size of user's buffer, Z is 
location of user's buffer, Only ''trusted'' routines may use 
this call. The central buffer is limited to 512 words. 
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9.5. INPUT/GUTPUT PROGRAMS AVAILABLE 


9.5.5. Illegal 
AAAA = 0077 


This is by definition an illegal job number, It is illegal as compared to 
undefined or not used. Certain ''trusted'' routines may use this number. 


9.540; READ OOD-PARITY (BINARY) TAPE 


> oe eneheeh & & Be Wee OO eeeeee Qe eseogeaawsee#weeeeeseetcesewses @& 


AAAA « 0410 READ OOD-PARITY (BINARY) TAPE 


ONE ENTIRE RECORD JS READ EACH TIME THIS 1/6 PROGRAM JS USED. WHEN THE {05 [3S COMPLETED, 
FIELD G6 OF THE JOD WILL CONTAIN THE NUMBER OF THELVE-BIT BYTES (THAT JS, THE NUMBER OF PPU 
WORDS) WHICH HERE TRANSMITTED TO CENTRAL MEMORY, 


FIELD Y GF THE [8D SPECIFIES THE BUFFER LENGTH, THIS LENGTH [S [NTERPRETED AS AN UPPER 
LIMIT ON THE NUMBER OF HORDS TO BE READ. THIS UPPER LIMIT HILL NEVER BE EXCEEDED BY THE 
1/8 PROGRAM, 
IF -H- REPRESENTS THE NUMBER OF KORDS ACTUALLY [IN A RECORD, GNE OF THREE CASES RESULT: 

1} Re (FIELD Y), AND S#H IS IN FIELD G, 

2) WH < (FIELD Yi, AND 5*k IS IN FIELD G. 


3) H> (FIELD Yi, AND Se(PIJELD Y) IS IN FIELD G. 


IN CASE 3, AN ERROR HILL BE SET INDICATING THAT THE BUFFER HAS NOT LARGE ENOUGH. 
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9,6,7, WRITE ODD=PARI TY (BItARY) TAPE 


9B, ESSER RRERRBaeestseReezreewzrErczagetseReecRwee eee 


AAAA » O41| WRITE GO0°PARITY (QINARY) YAPC 


IF FIELD G OF THE [6D IS ZERO, THE NUMBER OF SIXTY-BIT HORDS TO BE WRITTEN JS TAKEN FROM 
FIELD Y. JF FIELD G OF THE 10D IS NOT ZERS, THE NUMBER OF THELVE-BIT KORDS TS SE HRITTEN 
1S TAKEN FROM FIELD G. FIELD G MUST NOT EXCEED FIVE TIMES FIELD Y. 


IF A BAD SPOT IS ENCOUNTERED, THE RECORD HILL BE REKXRITTEN UP TO SEVEN TIMES. JF THIS 
FAILS AND THE L BIT OF THE 10D IS ZERO, THEN ENOUGH TAPE HILL BE ERASED TO PRODUCE A 
ERROR-FREE WRITE. IF, HOAEVER, A PARITY-FREE ARITE [S NOT EXECUTED AFTER A REASONABLE 
NUMBER OF TRIES (AT PRESENT, 105). JF THE TaPE [S NON-ERASASLE, OR iF THE END-OF-TAPE [5S 
PASSED, THEN A PARITY-ERROR/END-OF-TAPE (0012) HILL BE STORED IN THE F FIELD OF THE i0D. 
AN END-OF-FILE HILL BE WRITTEN ON THE TAPE AND THE TAPE WILL BE BACKSPACED OVER THE 
END-OF*FILE, NOTE THAT THIS JS THE ONLY PARITY RETURNED HHEN L « O, 


25 04 G: DISC READ 


AMAA « 0412 DISC READ 
AT END OF OPERATION, THE X FIELD KILL CONTAIN THE CPU WORD COUNT FOR THIS READ. 


TF G IS GREATER THAN THE FILE SIZE, ERROR 4004 (GUT OF BOUNDS DISC REFERENCE) ILL BE 
PLACED IN THE F FIELD AND THE PROGRAM KILL BE KILLED. 


TF G YS NOT GREATER THAN THE FILE SIZE BUT Gey [S, OC20 (END OF FILE) WILL BE PLACED IN 
THE FOFTELD AND (FILESIZE=0) HILL BE PLACED TN THE X FLELD (THAT 1S, THE NUMBER OF HORDES 
READI, THIS NUMBER WILL BE GREATER THAN CERO, BUT NOT GREATER THAN ¥, DATA UP TO THE END 
OF THE FILE WILL BE TRANSMITTED, 


Errata | 
October 1, 1970 
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9.5. INPUT/OUTPUT PROGRAMS AVAILABLE 


Vd 9: DISC WRITE 


eos oe oemneeweweeweseeees @ @& @ 


AAAA »@ O413 DISC WRITE 


If THE V-FIJELD IS ZERO, THIS 1/9 PROGRAM HILL HRITE SPECIFIED DATA ON DISC. AS EACH 
64-RKORD BLOCK IS WRITTEN, THE X FIELD 1S UPDATED TO GIVE A DYNAMIC CPU KORD COUNT. 


IF G IS GREATER THAN THE FILE SIZE, 4004 (OUT OF BOUNDS DISC REFERENCE) HILL BE PLACED IN 
TRE F FIELD AND THE PROGRAM WILL BE KILLED. 


IF G IS NOT GREATER THAN THE FILE SIZE BUT Gty [$, 0020 (END OF FILE) KILL BE PLACED IN 
THE F FIELD AND (FILES(ZE+G) WILL BE PLACED IN THE X FIELD (THAT IS, THE NUMBER OF KORDS 
KRITTEN). THIS NUMBER HILL BE GREATER THAN CERO, BUT NOT GREATER THAN Y. DATA UP TO THE 
END OF THE FILE WILL BE TRANSMITTED. 


IF THE V-FIELD IS A ONE, THE PPU HILL RITE A SPECIFIED THELVE-BIT PATTERN INTO ANY 
SPECIFIED PORTION OF THE DISC FILE, THE THIRD HORD OF THE [0D HAS A SPECIAL FORMAT FOR 
THIS CASE, GIVEN BY 


-G66G6G6G666666  G6G6GGGGGGG6GG PPPPPPPPPPPP ----- YY YY YYY VVC YYY: YYY YY¥, 


GG...G IS THE FIRST DISC KORD ADDRESS FOR THE KRITE OPERATION. 
PPouccP 2S THE TRELVE*BIT PATTERN T@ BSE WRITTEN IN THE DISC FILE. 
YY...Y 17S THE NUMBER SF SIXTY-BIT WORDS TO BE FILLED WITH THE DESIRED DISC PATTERN 


Pe aces 


THES USE. OF THE “DISC WRITE* 1/9 PROGRAM ALLOHS A PROBLEM PRUGRAM TO CLEAR ALL OR PART 
Cr A DISC FILE, OR TO RRITE A DISC PATTERN IN THE DISC FILE, WITHOUT CREATING A BUFFER IN 
THE PROBLEM PROGRAM'S GHN STORAGE. 
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9.5.10. READ TAPE UNIT STATUS 


AAAA & 2000 READ TAPE UNIT STATUS 


TRE TAPE UNIT STATUS IS RETURNED IN THE Z-FIELD OF THE TOD. MULTIPLE STaTUS STATES ARE 
LOGICALLY ADDED TOGETHER; FOR EXAMPLE, 0005 INDICATES: {) THE TAPE UNIT [S$ READY. 23 
THERE 1S A RING IN THE TAPE. 3) THE TAPE UNIT IS SET TS 200 BPI. 


XXX1 READY. 

XXX2 BUSY. 

XXX4 WRITE ENABLE (THERE JS A RING IN THE TAPE). 
XX1X FILEMARK. 

XX2X LOAD POINT. 

XX4X END Or TAPE. 

XOXX DENSITY 200 BPI. 

XIXX DENSITY 556 BPI. 

X2XX DENSITY 800 SPI. 

X4XX LOST DATA, 

[XXX END-OF -OPERATION, 

2XXX PARITY ERROR, 

4XXX RESERVED BY OTHER CHANNEL. 


9.5.11. REWIND 


AAAA «= 2001 REWIND 


9.5.12. REXIND UNLOAD 


AAAA « 2002 REWIND UNLOAD 
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9.5.13. RITE FILEMARK 


AAAA « 20083 WRITE FILEMARK 


9.5.14. SET DENSITY TO 200 BPI 


AAAA = 2010 SET DENSITY TO 200 B.P.J. 


FoOs15.- SET OENSTTY 10 596 BPI 


AAAA « 2011 SET DENSI IY: 10 556-5;? 1. 


9.5.16. SET DENSITY TO 800 BPI 


Soe eeceee oe @eeeete &ee2QQ eee @Owee Gewese ®&® we B® 


AAAA « 2012 SET DENSITY TO 800 B.P.J. 
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9,6,1, NOTES ON THE OPERATION OF 1/0 PACKAGES 


®@weOeevuseeGeoeeewshRHReamGoesGOteu GBbteaheGGtbe GRSRBKGKBOKBEHEHHEALHE HE BEKH SG 


WHEN A PART TY BAKOR TS ENCOUNTERED READING A WITAKY TAPE, SEVER ATTUMPTG AR MADE FO READ 
THE RECORD CORRECTLY, JP A SUCCESSFUL ROAD CANNOT GE MADE, THE TAPE [S LEFT POSITIONED Ot 
THE FAR SIDE OF THE BAD RECORD, THE INFORMATION IN THE RECORD 1S LEFT TN CENTRAL MEMORY 
FROM THE LAST ATTEMPT, 


BCD TAPE ROUTINES ALLOW FOR A MAXIMUM BUFFER SIZE SF 7202 CHARACTERS. THIS ALLOHS THE 
PROGRAM TO PUT OUT RECORDS EQUAL IN SIZE TO A RADIATION-PRINTER PAGE PLUS THE PAGE-RESTORE 
CHARACTER (OCTAL (6). THE PRESENCE OF THIS CHARACTER ANYHRERE IN A RECORD CAUSES TRE 
RADIATION PRINTER (AND $C-5000) TO SPACE TO THE TOP OF THE NEXT PAGE ON ENCOUNTERING THE 
END OF THAT RECORD. 


ALL TAPE ROUTINES KHICH READ OR HRITE TAPE ARE SINGLE-RECORD ROUTINES. 


THE TAPE*READ ROUTINES READ UNDER RECORD CONTROL. THAT IS, THE PPU READS A SINGLE RECORD 
AND TRANSMITS JT TO CENTRAL MEMORY, FOR BCD TAPES THE MAXIMUM RECORD THAT CAN BE READ [5 
7202 CHARACTERS, IF THE NUMBER OF CPU RKORDS IN THE RECORD 1S GREATER THAN THE SIZE OF THE 
BUFFER SPECIFIED IN THE 10D, THE PPU KILL TRANSMIT AS MANY HORDS TO CENTRAL MEMORY AS WILL 
FIT, AND WILL SIGNAL AN ERROR (0004), 


9.0.2. STANDARD [1/0 ERROR MESSAGES 


THE FOLLOWING VALUES ARE PLACED IN THE F FIELD OF THE [0D AS THE OCCASION DEMANDS. 


COOO0 = NU ERRORS. 

OOO01 « DeVICe NOT READY OR RESPONDING TO STATUS REQUEST. 

0002 = PARITY ERROR, 

0004 = DATA EXCEEDS PROGRAMMER’S BUFFER. 

OO10 « END OF TAPE, 

O020 -« -END-Or=F ILE CONDITION. 

CO40 © ATTEMPT TO RRITE FILE-PROTECTED TAPE OR READ-ONLY DISC FILE. 
0100 «© CHANNEL FAILURE, | | 
0200 © LOST DATA ON TAPE RECORD, 

0400 «© ATTEMPT TO BACKSPACE OVER LOAD POINT. 


IN THE EVENT OF MORE THAN ONE ERROR, THE ABOVE NUMBERS ARE LOGICALLY ADDED TOGETHER, 
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9.6. ERROR INDICATIONS 


4001 © DEVICE NOT ASSIGNED TO PROBLEM PROGRAM (YACUGUS OR IMPROPER MINUS 
RORD), : 

4002 « OUT-OF-BCUNDS MEMORY REFERENCE. 

4004 « QOUT-CF-BOUNDS DISC REFERENCE. 

4006 « (ILLEGAL 10D. 


TXXX # TLLEGAL A-FIELD IN [0D REQUEST. A-FUELD REQUESTED IS "XXx’, 


Note that all errors greater than 4000 are programmer errors. They are 
considered irremediable by FROST and will cause the I/O request to be 
terminated unconditionally. *(13)* If bit P (see 9.4.1) is zero, the user's 
program will be killed. If P is one, the user will get control and must exam- 
ine the upper bit in the error field to determine if the YO request was fatal. 


9.0435: MISCELLANEGUS PP ERROR MESSAGES 


2 eee e @ @eeeeoces &G& eee ee @ee ee; osuneesees &@&Se eevee eves @& 


THE FOLLOWING CODES MAY APPEAR ON THE TELETYPE IMMEDIATELY IN FRONT OF THE "ALL DONE’ 
MESSAGE. EACH CODE INDICATES THAT THE PROBLEM PROGRAM HAS BEEN KILLED (THAT JS, REMOVED 
FROM THE ALTERNATOR LOOP) AND PLACED BACK ON DISC. 


MISCELLANEOUS PROBLEM PROGRAM ERRORS NOT INVOLVING AN 10D, 


200 PROBLEM PROGRAM NADE OUT-OF-BOUNDS MENGRY REFERENCE OR AN ILLEGAL FROST 
SYSTEM CALL, THESE THO ARE INOISTINGUISHASLE, 

201 PROBLEM PROGRAM REQUESTED TO RETURN FROM AN INTERRUPT RHEN ALREADY AT THE 
MAIN PROGRAM LEVEL. 

202 illegal CMPPU system call. 

203 EXCHANGE-JUMP-REQUEST WORD (HORD ZERO) POINTS CUT-OF-BOUNDS. 

204 INPUT/OUTPUT REQUEST WORD (KORD ONE) POINTS OUT-OF-BSUNDS. 

205 TOO MANY [OD°S LISTED WHEN ADDING PROBLEM PROGRAM TO THE ALTERNATOR 
LOOP, 

206 {6D ADDRESS 1S OUT OF BOUNDS HHEN ADDING PROBLEM PROGRAM TO ALTERNATOR 
LOOP, 

207 PROBLEM PROGRAM CALLED FOR TOO MANY EXCHANGE JUMP PACKAGES, 


@e @@eeeeeewee eeeee ®& rs 


e(13)" SIMILAR ACTION RESULTS FOR ERRORS 0002 (WHILE HRITING DISC) AND 4007, 
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9.6. ERROR INDICATIONS 


ERRORS WHICH INVOLVE AN JOD. 


300 
301 
302 
303 
304 
305 


306 


307 
310 


INCORRECT MINUS HORD--ILLEGITIMATE CHANNEL NUMBER, 

ILLEGAL A-FIELD (MPPU-JCB). 

MINUS HORD HAS WRONG UNIT TYPE (MPPU-JOB). 

ToFIELD OF I0D POINTS OUT-OF -BOUNDS, 

PROBLEM PROGRAM HAS SUBMITTED TOC MANY 100'S (MORE THAN 31 DECIMAL), 
PROBLEM PROGRAM HAS SUBMITTED TOO MANY [00'S FOR ONE DEVICE (MORE THAN 
FIFTEEN). 

PROBLEM PROGRAM ERROR DETECTED BY SLAVE PPV KHILE EXECUTING AN 10D. 
EXAMINE FIELD F OF THE IOD. 

ADDRESS OF CONTINGENT [10D IS OUT-OF-BOUNDS. 

INTERRUPT ADDRESS JS OUT*OF-BOUNDS, 


Errata 1 
December 3, 1969 
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Appendix A 
Minus Word Formats 
The "minus words" described pertains to that block of 256 (400 octal) 


words added prior to every problem program's relative word 0 (zero). 
These words are not accessible to.the executing program. 


A Word @ -- Usually the name of the problem program in ASCII -- not 

looked at or used by Frost. 

B Word 1 -- Consists of four fields, three of which Frost looks at. 
59 FREEP 42 41 30 29 CUREX 12 11 NXJP @ 
where: 

NXJP -- number of exchange packages. This is usually 1 upon 


startup of execution. 


CUREX -- a relative pointer to the current exchange package 
within the minus words. Should be zero upon start-up 
of execution and is filled in by Frost. If it is zero. 
Frost assumes the first exchange package to be located 
at word 2. If it is not zero, Frost assumes it is indeed 
a pointer to the current exchange package. 


FREEP -- a relative pointer to the first free exchange pckkage 
area. Exchange packages areas are 18 words in length and 
up to 9 exchange packages can be stored in the minus words 
FREEP should be zero upon startup of execution and if so, 
it is filled in by Frost to point to word 20. The 
assumption made is only one exchange package at startup 
execution; therefore, the second exchange package area 
at word 20 is free. If not zero, Frost assumes this is a 
pointer to the first free area. 


Errata l 
December 3, 1969 
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C Words 2-19; 20-37; 38-55; 56-73; 74-91; 92-109; 110-127; 128-145; 146-163-- 


Are exchange package areas -- 18 words each as follows: 
Word 1: (Sometimes referred to as the 17th exchange package 
word.) 
XJA [Ost GBST DISS C 
59 42 41 39 38 37 36 35 28 27 24 23 
Where 
XJA -- a pointer to either next exchange package to be 


executed or next free exchange package area’ 
depending on whether this one is free or in use. 


IOST -- If this bit is on, this exchange package is I/O stuck. 


GBST -- If bit is on, this exchange package is GOB-Stuck 
(i.e., wishes to make a system call, but is prohibited 
from doing so until I/O has completed.) True for a 
certain class of system calls. 


DISS -— A bit, if on, indicating this exchange package is 
disabled, i.e., usually an exchange package for an 
I/O interrupt routine and the disabled bit on says 
do not interrupt this exchange package with a new 
one. If bit is off, then a new exchange package 
(usually the result of another enue I/O operation) 
can interrupt this one. 3 


C - fod number (1-17 octal), if any, associated with this 
exchange package (again apt to be an I/O interrupt 
exchange package). This iod number taken from the C 
field in Word 1 of an iod. 


Word 2: Contents of Word @ (zero) of the problem program 
the last time it was executing. 


WORD 3 -- starts the 16 word exchange package of registers, etc. 
BITS 53-36 P Counter 
BITS 35-18 AO Address Register 
BITS 17-0 BO Index Register 
WORD 4 -- BITS 53-36 Relative address 
BITS 35-18 Al Address Register 


BITS 17-0 Bl Index Register 


Change 3: Dec, 14, 1973 
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WORD 5 ae BITS 53-36 


' EXLT Mode Register 


BITS 35-18 A2 Address Register 
BITS 17-0 B2 Index Register 
WORD 6 -- Thur Word 1¢ 
BITS 35-18 A3 through A7 Address Register 
BITS 17-0 B3 through B7 Index Register 
WORD 11 - 
WORD 18 -- X@ through X7 operand registers 
D Word 192 _— ASCII BCD word - STACKED IOD 
E Words 193, 
194 -- Used by Frost for restacking iod's. 
F Words 195 - 
223 -- Relative pointers to iod's not yet issued, but already 
requested by the problem program. 
G Words 224- 
239 -—- ASCII BCD names of files (tape and/or disc) associated 
| with words 240-255 in a one to one correspondence. 
H Words 240- 
255 -- Commonly referred to as "Minus Words 15 through 9." These 


are the minus words pointed to in an iod and describe the I/0 
device. Word 255 = Minus Word @; Word 254 = Minus Word 1, 
etc. These words are formatted as follows. 


psc | a [s] c | > | & | F 


og of 56 55 jo 22 


Where A 


THoaAwWwW SE 
nonow wou now ou 


0 read only 

1 read/write 

0 not a pool file 

1 pool file 

access information level 

channel number 

absolute first word disc address of file 
size of file which is 100(8) words longer 


48 47 24 23 0 


than user knows. 


rape = [5] 


o4 48 47 


channel number 
unit number (0-7) 


= 
a 
o) 
ey 
@) 
ve 
Ho 


Change 4: Jan, 29, 1974 
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DD80 or | | B | | ~ Dee | | 


Console 


PACK 


O93 48 41 56 


channel number 
10(8) console 
11(8) dd80 


where B 


B, 
Be, Giles ote 


ieee ee ae 


59: 58°57 S96 -O0° .03:-02: 46 47 24 23 21 20 0 


0 pack file 

1 pack unit 

O Read only 

1 read/write 
0 not pool file. 
1 pool file 


A 
B 
C 
D access information level 
E 
FE 
G 
H 


WoW om of ou ou 


channel number 
absolute first word disk address of file 
physical unit 


size of file (100, words longer than the user specified). 


Change 4: Jan, 29, 1974 
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Appendix B 
Formats for Tables in Call 24NN (p. 27). 

File Index Table (4 words/file, maximum 1088 files) 

Word 1 FILENAME 60 bits 
Word 2 ae SIZE v 

Word 3 94 | LOC gris DV « 
Word 4 LASTREF 94] FR ,| NOREF j5| HASH 15 
where: 


FILENAME = Name of file, ASCII BCD, right justified 
USERNO = Binary user number 


EXTRA = Number of words of extra disk space assigned 
(minimum disk space = 500, words) 


SIZE = Number of words in file (addressable space + 100, 
words for ID sector) 


CH. = ehannel 
BEGIN = First word of disk address 
LOC = 1 if read/write; = 41 if read only; = 2 if execute only e 
TR = Trust status 
AV = available 
UN = pack unit 
AC = @ if global; = 1 if restricted 
DV # O means divisional file and contains division number. 


LASTREF = Time file last referenced (i.e., opens and system 
dumps). Kept for purge purposes. Contains micro- 
second clock contents divided by 2**24, 


FR = Protection level of file 


Change 3: Dec, 14, 1973 
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NOREF = Number of references made to file (opens NOT 
reads and writes) 


HASH 


HASH index number (for search purposes) 


Correspondence Table (2 words/entry, 14 entries) 


Entry 1 - Console assignment 

Entry 2 ~ DD80 assignment | 

FNnUry<o - User-1 DD80 tape, unit B 

Entry 4 » Weera)CR ll tape; sii 

Entry 5 - User-1 HSP tape, unit D 

Entry 6-10 - Tape drives for units E thru I respectively 
Entry 11 - G machine scope J 

Entry 12 - G machine scope K 

Entry 13 = G machine unit. 

Fintry 14 = G machine unit WV 


Format for each entry: 


Word 2 not used 


where: T = Type of device 
U = Physical unit number 
CH = Channel number 
G = Give status 
MN = Minus word pointer 
VNAME = Device name, ASCII BCD (i.e., name by 
which device assigned by operator) 
DESC = @ device is free; # @ points to descriptor 


block of owner 


Change 38: Dec, 14, 19738 
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Disk Map Table (3 sections, 34149 words /section) 


Ist section - disk cabinet 9 
2nd section - disk cabinet 1 
3rd section - disk cabinet 2 


This table catalogues free space only. A zero entry indicates end 
of information for the particular disk cabinet. Format of each word is: 


LEN 30 | FWA 3 


where: LEN 


if 


length of free space 


FWA = starting disk address of free space 


